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, que já está configurado. Quando precisar adicionar uma nova cadeia de caracteres à sua extensão, adicione-a a esse 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 se lembre de que o processo de geração (aquele que usa o resjson e gera a classe TypeScript utilizável) converte sublinhado (_) em ponto (.).
Por exemplo, esta entrada:
"HelloWorld_cim_title": "CIM Component",
Gera a seguinte estrutura do acessador:
MsftSme.resourcesStrings<Strings>().HelloWorld.cim.title;
Adicionar outros idiomas para localização
Para a localização de outros idiomas, um arquivo strings.resjson precisa ser criado para cada idioma. Esses arquivos precisam ser colocados em \loc\output\{!ExtensionName}\{!LanguageFolder}\strings.resjson. Os idiomas disponíveis com pastas correspondentes são:
| Idioma | Pasta |
|---|---|
| Čeština | cs-CZ |
| Deutsch | de-DE |
| Inglês | 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 (Portugal) | pt-PT |
| Русский | ru-RU |
| Svenska | sv-SE |
| Türkçe | tr-TR |
| 中文(简体) | zh-CN |
| 中文(繁體) | zh-TW |
Observação
Se as necessidades da estrutura de arquivos forem diferentes dentro de loc/output, será preciso ajustar o localeOffset para a tarefa gulp “generate-resjson-json-localized” que está no gulpfile.js. Esse deslocamento indica em que profundidade da pasta loc deve-se começar a pesquisar arquivos strings.resjson.
Cada arquivo strings.resjson será formatado da mesma forma como foi 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ê adicionar cadeias de caracteres localizadas, o gulp generate deve ser executado novamente para que elas sejam exibidas. Execute:
gulp generate
Para confirmar se as cadeias de caracteres foram geradas, navegue até \src\app\assets\strings\{!LanguageFolder}\strings.resjson. Sua entrada recém-adicionada será exibida nesse arquivo.
Agora, se você trocar a opção de idioma no Windows Admin Center, poderá ver as cadeias de caracteres localizadas em sua extensão.