Windows Admin Center での文字列とローカライズ
Windows Admin Center の拡張機能 SDK について詳しく見ていき、文字列とローカライズについて説明します。
プレゼンテーション層に表示されるすべての文字列のローカライズを有効にするには、既に設定されている /src/resources/strings の下にある strings.resjson ファイルを利用します。 拡張機能に新しい文字列を追加する必要がある場合は、この resjson ファイルに新しいエントリとして追加します。 既存の構造は、次の形式に従います。
"<YourExtensionName>_<Component>_<Accessor>": "Your string value goes here.",
文字列には任意の形式を使用できますが、生成プロセス (resjson を取り込み、使用可能な TypeScript クラスを出力するプロセス) では、アンダースコア (_) がピリオド (.) に変換されることに注意してください。
例えば、次のエントリがあるとします。
"HelloWorld_cim_title": "CIM Component",
これにより、次のアクセサー構造が生成されます。
MsftSme.resourcesStrings<Strings>().HelloWorld.cim.title;
ローカリゼーションのために他の言語を追加する
他の言語にローカライズする場合は、各言語に対して strings.resjson ファイルを作成する必要があります。 これらのファイルは、\loc\output\{!ExtensionName}\{!LanguageFolder}\strings.resjson に配置する必要があります。 使用できる言語と対応するフォルダーは、次のとおりです。
| Language | Folder |
|---|---|
| Čeština | cs-CZ |
| Deutsch | de-DE |
| 英語 | ja-JP |
| Español | es-ES |
| Français | fr-FR |
| Magyar | hu-HU |
| Italiano | it-IT |
| Japanese | 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 |
注意
ファイル構造のニーズが loc/output の内部で異なる場合は、gulpfile.js にある gulp タスク ‘generate-resjson-json-localized' の localeOffset を調整する必要があります。 このオフセットは、strings.resjson ファイルの検索を開始する必要がある loc フォルダーの深さのことです。
それぞれの strings.resjson ファイルは、このガイドの冒頭で説明したのと同じ方法で書式設定されます。
たとえば、スペイン語のローカライズを含めるには、次のエントリを \loc\output\HelloWorld\es-ES\strings.resjson に追加します。
"HelloWorld_cim_title": "CIM Componente",
ローカライズされた文字列を追加した場合は、それらが表示されるようにするために、gulp generate を再実行する必要があります。 次を実行します。
gulp generate
文字列が生成されたことを確認するには、\src\app\assets\strings\{!LanguageFolder}\strings.resjson に移動します。 新しく追加されたエントリがこのファイルに表示されます。
ここで、Windows Admin Center で言語オプションを切り替えると、ローカライズされた文字列が拡張機能に表示されます。