Stringhe e localizzazione in Windows Admin Center
Esame in dettaglio Windows Admin Center Extensions SDK e illustrazione di stringhe e localizzazione.
Per abilitare la localizzazione di tutte le stringhe di cui viene eseguito il rendering sul livello di presentazione, è già configurato il file strings.resjson in /src/resources/strings. Quando è necessario aggiungere una nuova stringa all'estensione, aggiungerla a questo file resjson come nuova voce. La struttura esistente segue questo formato:
"<YourExtensionName>_<Component>_<Accessor>": "Your string value goes here.",
È possibile usare qualsiasi formato desiderato per le stringhe, ma tenere presente che il processo di generazione (il processo che accetta resjson e restituisce la classe TypeScript utilizzabile) converte il carattere di sottolineatura (_) in punti (.).
Si consideri ad esempio la voce seguente:
"HelloWorld_cim_title": "CIM Component",
Genera la struttura della funzione di accesso seguente:
MsftSme.resourcesStrings<Strings>().HelloWorld.cim.title;
Aggiungere altre lingue per la localizzazione
Per la localizzazione in altre lingue, è necessario creare un file strings.resjson per ogni lingua. Questi file devono essere inseriti in \loc\output\{!ExtensionName}\{!LanguageFolder}\strings.resjson
. Le lingue disponibili con le cartelle corrispondenti sono:
Lingua | Cartella |
---|---|
Čeština | cs-CZ |
Deutsch | de-DE |
Inglese | it-IT |
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 (Brasile) | pt-BR |
Português (Portugal) | pt-PT |
Русский | ru-RU |
Svenska | sv-SE |
Türkçe | tr-TR |
中文(简体) | zh-CN |
中文(繁體) | zh-TW |
Nota
Se le esigenze della struttura dei file sono diverse all'interno di loc/output, sarà necessario modificare le impostazioni localeOffset per l'attività ‘gulp generate-resjson-json-localized' che si trova nel gulpfile.js. Questo offset è il livello di profondità nella cartella loc che dovrebbe iniziare a cercare i file strings.resjson.
Ogni file strings.resjson verrà formattato nello stesso modo indicato in precedenza all'inizio di questa guida.
Ad esempio, per includere una localizzazione per Español includere questa voce in \loc\output\HelloWorld\es-ES\strings.resjson
:
"HelloWorld_cim_title": "CIM Componente",
Ogni volta che sono state aggiunte stringhe localizzate, è necessario eseguire nuovamente gulp generate per visualizzarle. Terza fase
gulp generate
Per verificare che le stringhe siano state generate, passare a \src\app\assets\strings\{!LanguageFolder}\strings.resjson
. La voce appena aggiunta verrà visualizzata in questo file.
Ora, se si cambia l'opzione di lingua in Windows Admin Center, sarà possibile visualizzare le stringhe localizzate nell'estensione.