Строки и локализация в Windows Admin Center

  • Применяется к: ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Давайте подробно рассмотрим пакет SDK расширений Windows Admin Center и поговорим о строках и локализации.

Чтобы включить локализацию всех строк, отображаемых на уровне презентации, воспользуйтесь файлом strings.resjson в разделе /src/resources/strings — он уже настроен. Когда необходимо добавить новую строку в расширение, добавьте ее в этот 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. Доступные языки с соответствующими папками:

Language 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
Português (Brasil) pt-BR
Português (Португалия) pt-PT
Русский ru-RU
Svenska sv-SE
Türkçe tr-TR
中文(简体) zh-CN
中文(繁體) zh-TW

Note

Если ваши потребности в структуре файлов отличаются внутри loc/output, необходимо настроить localeOffset для задачи gulp «generate-resjson-json-localized», которая находится в gulpfile.js. Это смещение определяет, насколько глубоко в папке loc нужно начать поиск файлов strings.resjson.

Каждый файл strings.resjson будет отформатирован таким же образом, как упоминалось ранее в верхней части этого руководства.

Например, чтобы включить локализацию для Español, включите эту запись в \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 Admin Center, вы сможете увидеть локализованные строки в расширении.

  • Last updated on