Condividi tramite


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.