Chaînes et localisation dans Windows Admin Center
S'applique à : Windows Admin Center, Windows Admin Center Preview
Passons plus en détail au SDK d’extensions Windows Admin Center et parlons des chaînes et de la localisation.
Pour activer la localisation de toutes les chaînes rendues sur la couche de présentation, tirez parti du fichier strings.resjson sous /src/resources/strings ; il est déjà configuré. Lorsque vous devez ajouter une nouvelle chaîne à votre extension, ajoutez-la à ce fichier resjson en tant que nouvelle entrée. La structure existante suit ce format :
"<YourExtensionName>_<Component>_<Accessor>": "Your string value goes here.",
Vous pouvez utiliser n’importe quel format pour les chaînes, mais n’oubliez pas que le processus de génération (processus qui prend le resjson et génère la classe TypeScript utilisable) convertit le trait de soulignement (_) en point (.).
Par exemple, cette entrée :
"HelloWorld_cim_title": "CIM Component",
Génère la structure d’accesseur suivante :
MsftSme.resourcesStrings<Strings>().HelloWorld.cim.title;
Ajouter d’autres langues pour la localisation
Pour la localisation dans d’autres langues, un fichier strings.resjson doit être créé pour chaque langue. Ces fichiers doivent être placés dans \loc\output\{!ExtensionName}\{!LanguageFolder}\strings.resjson. Les langues disponibles avec les dossiers correspondants sont les suivantes :
| Langage | Dossier |
|---|---|
| Čeština | cs-CZ |
| Deutsch | de-DE |
| Anglais | fr-FR |
| Español | es-ES |
| Français | fr-FR |
| Magyar | hu-HU |
| Italiano | it-IT |
| 日本語 | ja-JP |
| 한국어 | ko-KR |
| Nederlands | nl-NL |
| Polski | pl-PL |
| Português (Brasil) | pt-br |
| Português (Portugal) | pt-PT |
| Русский | ru-RU |
| Svenska | sv-SE |
| Türkçe | tr-TR |
| 中文(简体) | zh-CN |
| 中文(繁體) | zh-TW |
Notes
Si vos besoins en matière de structure de fichiers sont différents à l’intérieur de loc/output, vous devez ajuster le paramètre localeOffset pour la tâche gulp « generate-resjson-json-localized » qui se trouve dans gulpfile.js. Ce décalage correspond à la profondeur du dossier loc à laquelle la recherche des fichiers strings.resjson doit commencer.
Chaque fichier strings.resjson est mis en forme de la même façon que mentionné précédemment au début de ce guide.
Par exemple, pour inclure une localisation pour l’espagnol, incluez l’entrée suivante dans \loc\output\HelloWorld\es-ES\strings.resjson :
"HelloWorld_cim_title": "CIM Componente",
Chaque fois que vous ajoutez des chaînes localisées, gulp generate doit être ré-exécuté pour qu’elles apparaissent. Exécutez :
gulp generate
Pour vérifier que vos chaînes ont été générées, accédez à \src\app\assets\strings\{!LanguageFolder}\strings.resjson. Votre entrée nouvellement ajoutée s’affiche dans ce fichier.
Maintenant, si vous changez l’option de langue dans Windows Admin Center, vous pouvez voir les chaînes localisées dans votre extension.