让我们更深入地了解 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\{!LanguageFolder}\strings.resjson 中。 具有相应文件夹的可用语言包括:
| 语言 | Folder |
|---|---|
| Čeština | cs-CZ |
| Deutsch | de-DE |
| English | en-US |
| Español | es-ES |
| Français | fr-FR |
| Magyar | hu-HU |
| Italiano | it-IT |
| 日本語 | ja-JP |
| 한국어 | ko-KR |
| Nederlands | nl-NL |
| Polski | pl-PL |
| 葡萄牙语(巴西) | pt-BR |
| 葡萄牙语(葡萄牙) | pt-PT |
| Русский | ru-RU |
| Svenska | sv-SE |
| Türkçe | tr-TR |
| 中文(简体) | zh-CN |
| 中文(繁體) | zh-TW |
Note
如果你的文件结构需求在 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 才能显示这些字符串。 Run:
gulp generate
要确认已生成字符串,请导航到 \src\app\assets\strings\{!LanguageFolder}\strings.resjson。 你新添加的条目将显示在此文件中。
现在,如果你在 Windows 管理中心中切换语言选项,你将能够看到扩展中的本地化字符串。