Cadeias de caracteres e localização no Windows Admin Center
Vamos nos aprofundar mais no SDK de Extensões do Windows Admin Center e falar sobre cadeias de caracteres e localização.
Para habilitar a localização de todas as cadeias de caracteres renderizadas na camada de apresentação, aproveite o arquivo strings.resjson em /src/resources/strings - ele já está configurado. Quando você precisar adicionar uma nova cadeia de caracteres à sua extensão, adicione-a a este arquivo resjson como uma nova entrada. A estrutura existente segue este formato:
"<YourExtensionName>_<Component>_<Accessor>": "Your string value goes here.",
Você pode usar qualquer formato que desejar para as cadeias de caracteres, mas esteja ciente de que o processo de geração (o processo que usa o resjson e gera a classe TypeScript utilizável) converte sublinhado (_) em pontos (.).
Por exemplo, esta entrada:
"HelloWorld_cim_title": "CIM Component",
Gera a seguinte estrutura de acessador:
MsftSme.resourcesStrings<Strings>().HelloWorld.cim.title;
Adicionar outros idiomas para localização
Para a localização para outros idiomas, um arquivo strings.resjson precisa ser criado para cada idioma. Esses arquivos precisam ser colocados em \loc\output\{!LanguageFolder}\strings.resjson. Os idiomas disponíveis com as pastas correspondentes são:
| Idioma | Pasta |
|---|---|
| Čeština | cs-CZ |
| Alemão | de-DE |
| Inglês | en-US |
| Español | es-ES |
| Français | fr-FR |
| Húngaro | hu-HU |
| Italiano | it-IT |
| 日本語 | ja-JP |
| 한국어 | ko-KR |
| Países Baixos | 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 |
Observação
Se suas necessidades de estrutura de arquivos forem diferentes dentro de loc/output, você precisará ajustar o localeOffset para a tarefa gulp 'generate-resjson-json-localized' que está no gulpfile.js. Esse deslocamento é o quão profundo na pasta loc ele deve começar a procurar por arquivos strings.resjson.
Cada arquivo strings.resjson será formatado da mesma forma que mencionado anteriormente na parte superior deste guia.
Por exemplo, para incluir uma localização para Español, inclua esta entrada em \loc\output\HelloWorld\es-ES\strings.resjson:
"HelloWorld_cim_title": "CIM Componente",
Sempre que você adicionou strings localizadas, gulp generate deve ser executado novamente para que elas apareçam. Executar:
gulp generate
Para confirmar que suas cadeias de caracteres foram geradas, navegue até \src\app\assets\strings\{!LanguageFolder}\strings.resjson. Sua entrada recém-adicionada aparecerá neste arquivo.
Agora, se alternares a opção de idioma no Windows Admin Center, poderás ver as cadeias de caracteres localizadas na tua extensão.