Usare Multilingual App Toolkit

  • Articolo

Multilingual App Toolkit (MAT) si integra con Microsoft Visual Studio per fornire alle app di Windows il supporto per la traduzione, la gestione dei file di traduzione e gli strumenti dell'editor. Ecco alcune delle proposte di valore del toolkit.

  • Consente di gestire le modifiche delle risorse e lo stato della traduzione durante lo sviluppo.
  • Fornisce un'interfaccia utente per la scelta delle lingue in base ai provider di traduzione configurati.
  • Supporta il formato di file XLIFF standard del settore di localizzazione.
  • Fornisce un motore pseudo-linguistico per identificare i problemi di traduzione durante lo sviluppo.
  • Connessione con Portale linguistico Microsoft per accedere facilmente a stringhe tradotte e terminologia.
  • Connessione con Microsoft Translator per suggerimenti rapidi per la traduzione.

Come usare il toolkit

Passaggio 1: Progettare l'app per la globalizzazione e la localizzazione

Prima di poter usare il MAT in modo efficace, l'app deve essere localizzabile. In particolare, il progetto deve contenere uno o più file di risorse (.resw) contenenti le stringhe dell'app nella lingua predefinita. Per altri dettagli, consultare Localizzare le stringhe nell'interfaccia utente e nel manifesto del pacchetto dell'app. Al termine, il toolkit semplifica l'aggiunta di altre lingue.

Per la proposta di valore della globalizzazione e della localizzazione, nonché per le definizioni dei termini globalizzazione, localizzazione e localizzazione, consultare Globalizzazione e localizzazione.

Inoltre consultare Linee guida per la globalizzazione e Rendere l'app localizzabile.

Passaggio 2. Scaricare e installare Multilingual App Toolkit

Multilingual App Toolkit (MAT) è composto da due parti, ognuna con il proprio programma di installazione.

Se si usa Visual Studio 2017 o versione successiva, scaricare ed eseguire entrambi i programmi di installazione, uno dopo l'altro. Se si usa Visual Studio 2015 o Visual Studio 2013, scaricare ed eseguire il programma di installazione .msi.

Passaggio 3. Abilitare Multilingual App Toolkit per il progetto

Il MAT deve essere abilitato per il progetto prima di iniziare a localizzare l'app. Ecco come abilitare il toolkit.

  • Aprire la soluzione del progetto in Visual Studio.
  • Selezionare il progetto desiderato in Esplora soluzioni.
  • Nel menu Strumenti, selezionare Multilingual App Toolkit>Abilita selezione.

Nella finestra di Output (che mostra l'output di Multilingual App Toolkit), controllare il messaggio Project '<project-name>' was enabled. The project's source culture is '<language-tag>' <language-name>. Se viene visualizzato questo messaggio, il MAT è pronto per l'uso.

Passaggio 4. Aggiungere lingue al progetto

Seguire questa procedura per aggiungere lingue al progetto.

  1. Fare clic con il pulsante destro del mouse sul nodo del progetto in Esplora soluzioni.
  2. Fare clic su Multilingual App Toolkit>Aggiungi lingue di traduzione....
  3. Nella finestra di dialogo Lingue di traduzione selezionare le lingue che si desidera supportare e fare clic su OK.

Il toolkit esegue queste operazioni in risposta.

  • Per ogni lingua aggiunta, viene creata una nuova cartella denominata per il tag di lingua BCP-47 della lingua. All'interno di tale cartella vengono creati nuovi file di risorse (.resw) in modo che corrispondano a quello contenuti nelle stringhe di lingua predefinite.
  • Se è la prima volta che è stata aggiunta una lingua, viene aggiunta al progetto una nuova cartella denominata MultilingualResources. All'interno di tale cartella viene aggiunto per ogni lingua un file .xlf. I file .xlf contengono un'unità di conversione per ogni stringa in ogni file di risorse (.resw) nel progetto.
  • La finestra di Output conferma l'aggiunta delle lingue aggiunte.

Ogni volta che si aggiunge/rimuove un file di risorse di lingua predefinito (.resw) oppure si aggiunge/rimuove una stringa all'interno di un file di risorse della lingua predefinita (.resw), ricompilare il progetto per sincronizzare nuovamente i file .xlf. In questo modo, i file con estensione .xlf contengono l'unione delle stringhe nella lingua predefinita.

I provider di traduzione installati, ad esempio Portale linguistico Microsoft e Microsoft Translator, possono essere usati per tradurre le risorse dell'app. Quando un provider supporta una lingua specifica, l'icona del provider viene visualizzata accanto al nome della lingua nella finestra di dialogo Lingue di traduzione.

Nella finestra di dialogo Lingue di traduzione, tutte le lingue esistenti basate su .xlf, individuate dal toolkit hanno la casella di selezione selezionata in precedenza per indicare che la lingua è già inclusa nel progetto.

Dopo l'aggiunta di una lingua al progetto, non può essere rimossa deselezionando la casella nella finestra di dialogo Lingue di traduzione. Per rimuovere una lingua, fare clic con il pulsante destro del mouse sul file .xlf specifico della lingua e scegliere Elimina. Se si conferma, verrà eliminato anche il file di risorse corrispondente (.resw).

Passaggio 5. Testare l'app usando pseudo-lingua

La pseudo-lingua è una modifica artificiale del prodotto software destinato a simulare la localizzazione della lingua reale, ma rimane leggibile per i parlanti nativi. La pseudo traduzione sostituisce i caratteri ed espande la lunghezza della stringa di risorsa per rilevare potenziali problemi di localizzabilità o bug all'inizio del ciclo del progetto e prima dell'inizio della localizzazione.

Seguire questa procedura per pseudo-localizzare e testare il progetto.

  1. Usare la finestra di dialogo Lingue di traduzione per aggiungere la pseudo-lingua (pseudo) [qps-ploc] al progetto.
  2. Fare clic con il pulsante destro del mouse sul <project-name>.qps-ploc.xlf file in Esplora soluzioni e scegliere Multilingual App Toolkit>Genera traduzioni automatiche.
  3. In Impostazioni>Ora & Lingua>Regione & lingua>Lingue, fare clic su Aggiungi una lingua.
  4. Nella casella di ricerca digitare qps-ploc.
  5. Fare clic su English (qps-ploc) per aggiungerlo.
  6. Nell'elenco delle lingue, selezionare English (qps-ploc) e fare clic Imposta come predefinito.
  7. Testare l'app pseudo-localizzata. Ad esempio, cercare problemi di layout dell'interfaccia utente in cui non viene visualizzata tutta una stringa (la stringa viene troncata) o stringhe non tradotte (ma hardcoded).

Oltre alla sostituzione e all'espansione dei caratteri, lo pseudo motore fornisce un identificatore di rilevamento univoco per ogni risorsa. Questo tracker viene anteposto all'inizio di ogni stringa e racchiuso tra parentesi quadre [xxxxx]. È possibile usare questi tracker durante i test di ispezione dell'interfaccia utente visiva. Possono aiutare a tenere traccia di risorse specifiche nel prodotto, soprattutto se più risorse hanno testo simile o duplicato.

In questo esempio di testo "Hello, World!" la pseudo traduzione si espande per occupare circa il 30% di spazio sullo schermo e quindi applica lo strumento di rilevamento delle risorse.

"Hello World" -> "Ĥèĺļõ Ŵòŗłđ" -> "[!!_Ĥèĺļõ Ŵòŗłđ_!!]" -> "[hJ8s1][!!_Ĥèĺļõ Ŵòŗłđ_!!]"

Passaggio 6. Tradurre l'app in lingue selezionate

Multilingual App Toolkit è integrato nel processo di compilazione. Durante una compilazione, le stringhe aggiornate vengono aggiunte automaticamente a ogni file con estensione .xlf della lingua. Dopo aver testato l'app usando pseudo lingua, sono disponibili tre opzioni per tradurre l'app in altre lingue per il rilascio.

Opzione 1. Tradurre manualmente le stringhe

È possibile usare l'Editor multilingue per tradurre le stringhe singolarmente. Come già accennato, questo è incluso nel programma di installazione .msi.

  • Fare clic con il pulsante destro del mouse sul file con estensione .xlf da tradurre.
  • Fare clic su Apri con... e selezionare l'Editor multilingue. Facoltativamente, è possibile fare clic su Imposta come predefinito.
  • Per ogni stringa, Source mostra la stringa originale nella lingua predefinita. In Traduzione digitare la stringa tradotta nella lingua appropriata per il file con estensione .xlf che si sta modificando.
  • Una volta terminato, salvare e chiudere il file.

Ricompilare il progetto in modo che le stringhe tradotte vengano copiate nel file di risorse (.resw) corrispondente al file con estensione .xlf appena modificato.

È anche possibile avviare l'Editor multilingue in questo modo. Passare a Start, visualizzare tutte le app, aprire la cartella Multilingual App Toolkit e fare clic su Editor multilingue per avviarlo.

Opzione 2. Inviare i file con estensione .xlf a terze parti per la traduzione

Per esternalizzare il lavoro di traduzione e modifica ai localizzatori, selezionare i file .xlf desiderati in Esplora soluzioni, fare clic con il pulsante destro del mouse su di essi e fare clic su Multilingual App Toolkit>Esporta traduzioni....

Selezionare Output: destinatario nella finestra di dialogo Esporta risorse stringa e fare clic su OK, i file verranno compressi e allegati a una nuova email. Selezionare Output: Posizione della cartella di file, cercare una cartella e fare clic su OK, facoltativamente scegliere di comprimere i file, fare nuovamente clic su OK, i file verranno (zippati e) salvati nella posizione scelta, all'interno di una nuova cartella denominata per il progetto.

Dopo che i localizzatori completano il lavoro di traduzione e inviano i file con estensione .xlf tradotti, è possibile importarli nel progetto. Selezionare i file .xlf desiderati in Esplora soluzioni, fare clic con il pulsante destro del mouse su di essi e scegliere Multilingual App Toolkit>Importare/riciclare le traduzioni.... Fare clic su Aggiungi, passare ai file xlf o .zip e fare clic su Importa.

Nota Il processo di importazione esegue la convalida di base prima dell'importazione. In questo modo si garantisce che le informazioni sulle cultura di destinazione nei file importati corrispondano a quella nei file .xlf esistenti.

Ricompilare il progetto in modo che le stringhe tradotte vengano copiate nel file di risorse (.resw) corrispondente al file con estensione .xlf appena importato.

Questi provider di terze parti offrono servizi di localizzazione e possono supportare nell'attività.

Nota

L'elenco precedente viene fornito solo a scopo informativo e non è una sponsorizzazione. Microsoft non rilascia alcuna dichiarazione o garanzia relativa a questi fornitori o ai relativi servizi e, in nessun caso, Microsoft ha alcuna responsabilità per l'uso di tali fornitori o servizi. Eventuali domande o reclami relativi a tali fornitori o servizi devono essere indirizzati al fornitore appropriato.

Opzione 3. Usare i servizi di traduzione integrati

I servizi di traduzione sono integrati in Visual Studio IDE e nell'Editor multilingue. In questo modo è possibile accedere facilmente ai servizi di traduzione durante lo sviluppo del prodotto e la localizzazione delle risorse. Per questo servizio è necessaria una sottoscrizione dell'account Azure, come descritto in Microsoft Translator si sposta nel portale di Azure.

Per accedere ai servizi di traduzione all'interno di Visual Studio, selezionare e fare clic con il pulsante destro del mouse su uno o più file .xlf in Esplora soluzioni e scegliere Genera traduzioni automatiche.

L'Editor multilingue offre lo stesso supporto per la traduzione, nonché l'aggiunta di suggerimenti per la traduzione interattiva, che consentono di selezionare la traduzione più adatta alle stringhe di risorse. Dopo aver fornito il suggerimento di traduzione, è possibile ottimizzare la stringa per lo stile di traduzione.

Con Multilingual App Toolkit, vengono forniti due provider.

  • Il Portale linguistico Microsoft consente il supporto per il riutilizzo della traduzione e la corrispondenza della terminologia in base alle traduzioni del testo dell'interfaccia utente per prodotti e servizi Microsoft.
  • Il provider Microsoft Translator abilita servizi di traduzione automatica su richiesta.

L'utente e i traduttori possono gestire lo stato delle traduzioni nell'Editor multilingue per esaminare le traduzioni incerte in un secondo momento. È possibile impostare lo stato di ogni stringa nella scheda Proprietà. I valori di stato sono: Nuova, Necessità di revisione, Tradotta, Finale e Approvata. L'indicatore a sinistra della riga mostra lo stato. Quando tutte le righe vengono visualizzate in verde nell'Editor multilingue, il lavoro di traduzione è concluso.

Ricompilare il progetto in modo che le stringhe tradotte vengano copiate nel file di risorse (.resw) corrispondente al file con estensione .xlf appena modificato.

Passaggio 7. Caricare l'app in Microsoft Store

Prima di avviare il processo di certificazione di Microsoft Store, è necessario escludere il file <project-name>.qps-ploc.xlf dal progetto. La pseudo lingua viene usata per rilevare potenziali problemi di localizzazione o bug, ma non è una lingua valida di Microsoft Store. Se non viene rimossa, all'app verrà attribuito esito negativo durante il processo di certificazione di Microsoft Store.

Telemetria

L'estensione Multilingual App Toolkit Visual Studio (MAT VS) raccoglie i dati di utilizzo anonimi e li invia ai server Microsoft per migliorare i prodotti e i servizi. La telemetria è disattivata per impostazione predefinita e può essere abilitata o disabilitata in qualsiasi momento. Per altre informazioni, consultare Domande frequenti & risoluzione dei problemi di Multilingual App Toolkit.

Download

Servizi di traduzione