Cadenas y localización en Windows Admin Center
Vamos a profundizar más en el SDK de extensiones de Windows Admin Center y hablaremos sobre las cadenas y la localización.
Para habilitar la localización de todas las cadenas que se representan en la capa de presentación, aproveche el archivo strings.resjson en /src/resources/strings, que ya está configurado. Cuando necesite agregar una nueva cadena a la extensión, agréguela a este archivo resjson como una nueva entrada. La estructura existente sigue este formato:
"<YourExtensionName>_<Component>_<Accessor>": "Your string value goes here.",
Puede usar cualquier formato que quiera para las cadenas, pero tenga en cuenta que el proceso de generación (el proceso que toma el resjson y genera la clase TypeScript utilizable) convierte el carácter de subrayado (_) en puntos (.).
Por ejemplo, esta entrada:
"HelloWorld_cim_title": "CIM Component",
Genera la siguiente estructura de descriptor de acceso:
MsftSme.resourcesStrings<Strings>().HelloWorld.cim.title;
Agregar otros idiomas para la localización
Para la localización a otros idiomas, es necesario crear un archivo strings.resjson para cada idioma. Estos archivos deben colocarse en \loc\output\{!ExtensionName}\{!LanguageFolder}\strings.resjson. Los idiomas disponibles con las carpetas correspondientes son:
| Lenguaje | Carpeta |
|---|---|
| Čeština | cs-CZ |
| Deutsch | de-DE |
| Inglés | es-ES |
| 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 |
Nota
Si las necesidades de la estructura de archivos son diferentes dentro de loc/output, deberá ajustar la configuración regionalOffset para la tarea de gulp “generate-resjson-json-localized” que se encuentra en el gulpfile.js. Este desplazamiento es la profundidad en la carpeta loc que debe empezar a buscar archivos strings.resjson.
Cada archivo strings.resjson tendrá formato de la misma manera que se mencionó anteriormente en la parte superior de esta guía.
Por ejemplo, para incluir una localización para español, incluya esta entrada en \loc\output\HelloWorld\es-ES\strings.resjson:
"HelloWorld_cim_title": "CIM Componente",
Cada vez que haya agregado cadenas localizadas, gulp generate debe ejecutarse de nuevo para que aparezcan. Ejecute:
gulp generate
Para confirmar que las cadenas se han generado, vaya a \src\app\assets\strings\{!LanguageFolder}\strings.resjson. La entrada recién agregada aparecerá en este archivo.
Ahora, si cambia la opción de idioma en Windows Admin Center, podrá ver las cadenas localizadas en la extensión.