Zeichenfolgen und Lokalisierung im Windows Admin Center

Gilt für: Windows Admin Center, Windows Admin Center-Vorschau

Lassen Sie uns das SDK für Windows Admin Center-Erweiterungen genauer Windows und Zeichenfolgen und Lokalisierungen betrachten.

Um die Lokalisierung aller Zeichenfolgen zu aktivieren, die auf der Darstellungsschicht gerendert werden, nutzen Sie die Datei strings.resjson unter /src/resources/strings – sie ist bereits eingerichtet. Wenn Sie Ihrer Erweiterung eine neue Zeichenfolge hinzufügen müssen, fügen Sie sie dieser Resjson-Datei als neuen Eintrag hinzu. Die vorhandene -Struktur folgt diesem Format:

"<YourExtensionName>_<Component>_<Accessor>": "Your string value goes here.",

Sie können ein beliebiges Format für die Zeichenfolgen verwenden. Beachten Sie jedoch, dass der Generierungsprozess (der Prozess, der resjson verwendet und die nutzbare TypeScript-Klasse ausausgabet) Unterstriche (_) in Zeiträume (.) konvertiert.

Beispiel:

"HelloWorld_cim_title": "CIM Component",

Generiert die folgende Accessorstruktur:

MsftSme.resourcesStrings<Strings>().HelloWorld.cim.title;

Hinzufügen weiterer Sprachen für die Lokalisierung

Für die Lokalisierung in andere Sprachen muss eine strings.resjson-Datei für jede Sprache erstellt werden. Diese Dateien müssen in platziert werden \loc\output\{!ExtensionName}\{!LanguageFolder}\strings.resjson. Die verfügbaren Sprachen mit entsprechenden Ordnern sind:

Sprache Ordner
Čeština cs-CZ
Deutsch de-DE
Englisch de-DE
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

Hinweis

Wenn sich die Dateistrukturanforderungen innerhalb von loc/output unterscheiden, müssen Sie localeOffset für die Gulp-Aufgabe "generate-resjson-json-localized" anpassen, die sich im gulpfile.js. Dieser Offset gibt an, wie tief im Ordner loc nach strings.resjson-Dateien gesucht werden sollte.

Jede strings.resjson-Datei wird auf die gleiche Weise formatiert wie oben in diesem Leitfaden erwähnt.

Wenn Sie z. B. eine Lokalisierung für Polyol verwenden, schließen Sie diesen Eintrag in ein \loc\output\HelloWorld\es-ES\strings.resjson:

"HelloWorld_cim_title": "CIM Componente",

Wenn Sie lokalisierte Zeichenfolgen hinzugefügt haben, muss gulp generate erneut durchgeführt werden, damit sie angezeigt werden. Führen Sie folgenden Befehl aus:

gulp generate

Um zu bestätigen, dass Ihre Zeichenfolgen generiert wurden, navigieren Sie zu \src\app\assets\strings\{!LanguageFolder}\strings.resjson. Ihr neu hinzugefügter Eintrag wird in dieser Datei angezeigt. Wenn Sie nun die Sprachoption im Windows Admin Center wechseln, können Sie die lokalisierten Zeichenfolgen in Ihrer Erweiterung sehen.