让我们更深入地了解 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 管理中心中切换语言选项,你将能够看到扩展中的本地化字符串。