L'Editor traduzioni fornisce una visualizzazione consolidata e modificabile di tutte le tue impostazioni string Resources tradotte.
Per un'introduzione alla traduzione della tua app in diverse lingue, leggi Supportare diverse lingue e culture del mondo.
![](https://developer.android.com/static/studio/images/write/translations-editor-basic_2x.png?authuser=0000&hl=it)
Figura 1. L'Editor traduzioni che mostra il testo dell'app prima traduzione
Risorse stringa
Le risorse stringa per un progetto sono contenute in file strings.xml
. Il tuo progetto
ha un file strings.xml
predefinito che contiene risorse di tipo stringa nel
della tua app, ovvero quella che ti aspetti che la maggior parte degli utenti dell'app
per parlare. Puoi anche tradurre file strings.xml
contenenti stringhe
per le altre lingue che vuoi includere nell'app.
Una volta completato il file strings.xml
predefinito, puoi aggiungere le traduzioni
personalmente o pagare un servizio professionale per le traduzioni. In ogni caso, devi prendere
sfruttare le funzionalità di Android Studio per gestire ed eseguire test
localizzatore. Per informazioni
sui servizi di traduzione professionali, consulta Ordinare servizi di traduzione.
Apri l'editor di traduzioni
Puoi accedere all'editor di traduzioni dalle seguenti posizioni di Android Studio.
Apri dalla vista Android
- Nella sezione Progetto > nel riquadro Android a sinistra. seleziona ModuleName > res > personalizzati.
- Fai clic con il tasto destro del mouse sul file strings.xml e seleziona Apri l'editor di traduzioni.
L'editor delle traduzioni mostra le coppie chiave-valore del
strings.xml
.Nota: Quando hai tradotto
strings.xml
file, al tuo progetto sono corrispondenti più values con suffissi che indicano la lingua, come values-es per lo spagnolo. Il tuo filestrings.xml
predefinito si trova sempre values (senza suffisso).
La figura 1 mostra il testo predefinito dell'app (in questo caso, l'inglese) nell'editor delle traduzioni per
un'app semplice prima che finiscano le traduzioni. I contenuti della traduzione
I file strings.xml
verranno visualizzati a destra della colonna Non traducibile con
una colonna per lingua, come mostrato nella figura 2.
Apri dall'interno di tabs.xml
Puoi accedere all'Editor traduzioni da uno qualsiasi dei tuoi file strings.xml
.
- Nella sezione Progetto > Nel riquadro Android a sinistra, seleziona ModuleName > res > personalizzati.
- Fai doppio clic su strings.xml per aprirlo e modificarlo.
- In strings.xml, fai clic sul link Apri editor nell'angolo in alto a destra.
Nota: se fai clic sul link Nascondi notifica, tocca il pulsante Apri editor scompare. Per ripristinarlo, chiudi e riapri il progetto.
Apri dall'Editor di progettazione
Puoi aprire l'Editor traduzioni dall'Editor di progettazione dell'editor di layout per modificare predefinito e tradotto il testo per adattarlo meglio al layout. Per informazioni su come cambiare lingua nell'Editor di progettazione, consulta Visualizza il testo tradotto nell'Editor di progettazione.
- Nella sezione Progetto > Nel riquadro Android a sinistra, seleziona ModuleName > res > layout.
- Fai doppio clic su content_main.xml per aprirlo e modificarlo.
- Fai clic sulla scheda Design nell'angolo in basso a sinistra per visualizzare l'Editor di Design.
- In Design Editor, seleziona la Lingua
Elenco a discesa
.
- Seleziona Modifica traduzioni.
.
Configura righe non traducibili
Nell'Editor traduzioni, puoi selezionare Non traducibile per indicare che non desideri tradurre il testo in questa riga. Testo che vuoi potrebbero essere testi specifici del prodotto, come nomi commerciali e marchi, o termini tecnici senza traduzione.
Quando selezioni Non traducibile, la riga corrispondente nel testo predefinito
strings.xml
aggiunge translatable="false". Nell'esempio seguente,
App facile
nella riga superiore non è tradotto perché è il nome del prodotto.
<resources> <string name="app_name" translatable="false">EasyApp</string> <string name="action_settings">Settings</string> <string name="easy_app">I am a Simple App!</string> <string name="next_page">Next Page</string> <string name="second_page_message">I am the Second Page!</string> <string name="title_activity_second">SecondActivity</string> </resources>
Aggiungere ed eliminare lingue
L'Editor traduzioni supporta BCP 47 e Combina i codici di località e regione in un'unica selezione per le localizzazioni mirate. Le impostazioni internazionali non definiscono la lingua. Le impostazioni internazionali includono una formattazione basata sul paese per ad esempio data e ora, valute e decimali.
Per aggiungere una lingua:
- Nell'Editor traduzioni, fai clic sull'icona a forma di globo
.
- Dall'elenco a discesa, seleziona la lingua da aggiungere.
La nuova lingua viene visualizzata nell'Editor traduzioni e in values-* con un file
strings.xml
viene aggiunta al progetto. Ad esempio: values-es per lo spagnolo.
Per eliminare una lingua:
Puoi eliminare una lingua nell'Editor traduzioni eliminando ogni valore nella colonna (vedi modificare, aggiungere o eliminare testo) oppure eliminare la cartella del progetto per quella lingua, come segue:
- Nella sezione Progetto > Nel riquadro Android a sinistra, seleziona ModuleName > res.
- Fai clic con il pulsante destro del mouse sulla cartella values-* relativa alla lingua che vuoi eliminare. Ad esempio: values-hi per l'hindi.
- Seleziona Elimina dall'elenco a discesa per eliminare la cartella e i relativi strings.xml.
Modificare, aggiungere ed eliminare testo
Puoi operare sulle impostazioni del testo direttamente nel file strings.xml
oppure
tramite l'Editor traduzioni. Questa sezione descrive le
Approccio dell'editor delle traduzioni. Nell'Editor traduzioni, puoi modificare, aggiungere
eliminare testo dalla visualizzazione elenco o tramite
Il campo Traduzione nella parte inferiore dell'Editor traduzioni.
![](https://developer.android.com/static/studio/images/write/translation-field_2x.png?authuser=0000&hl=it)
Figura 2. Visualizzazione elenco in alto e il campo Traduzione in basso
Visualizzazione elenco
Per modificare o aggiungere testo:
- Fai doppio clic sulla cella in cui vuoi modificare o aggiungere testo.
- Esegui un copia e incolla dalla tastiera oppure se hai una tastiera che supporta il segno diacritico , digita direttamente nella visualizzazione elenco.
- Tab o sposta il cursore fuori dal campo.
Per eliminare il testo:
- Fai doppio clic sulla cella che vuoi eliminare.
- Nella visualizzazione elenco, seleziona il testo e premi Elimina.
- Tab o sposta il cursore fuori dal campo.
Campo di traduzione
Per modificare o aggiungere testo:
- Nella visualizzazione elenco, fai clic una sola volta sulla cella in cui vuoi modificare o aggiungere testo.
- Nel campo Traduzione, copia e incolla la tastiera, o se hai una tastiera che supporta i segni diacritici digita direttamente nel campo Traduzione.
- Tab o sposta il cursore fuori dal campo.
Per eliminare il testo:
- Fai clic una sola volta sulla cella da eliminare.
- Nel campo Traduzione, seleziona il testo e premi Elimina.
Aggiungere ed eliminare chiavi
Nell'editor delle traduzioni, la colonna Chiave elenca gli identificatori univoci per ogni
nei tuoi file strings.xml
. Puoi aggiungere ed eliminare chiavi tramite la
Editor di traduzioni. Quando elimini una chiave, l'editor di traduzioni la elimina insieme a tutti i suoi
traduzioni associate. L'Editor traduzioni utilizza il refactoring dell'eliminazione sicura per
eliminare una chiave in modo da sapere se il testo della chiave è utilizzato altrove e avere la possibilità
per apportare le modifiche necessarie prima di eliminare la chiave. La modifica dell'eliminazione sicura garantisce che
il codice viene comunque compilato dopo l'eliminazione della chiave.
Per aggiungere una chiave, procedi nel seguente modo:
- Nell'Editor traduzioni, fai clic su Aggiungi chiave.
.
- Nella finestra di dialogo, inserisci il nome della chiave, il valore predefinito e la posizione
il file predefinito strings.xml.
Figura 3. Aggiungi una chiave
Per eliminare una chiave:
- Nell'editor delle traduzioni, seleziona la chiave che vuoi eliminare.
- Fai clic su Rimuovi chiavi
.
Nella finestra di dialogo Elimina, decidi se vuoi un'eliminazione sicura e se vuoi cercare nei commenti e nelle stringhe, quindi fai clic su OK.
Figura 4. Finestra di dialogo Elimina
Se non sono presenti riferimenti (utilizzi) della chiave eliminata o se tutti i riferimenti sono al sicuro comprimibile, la chiave viene eliminata. In caso contrario, l'Editor traduzioni mostra Finestra di dialogo Utilizzi rilevati con informazioni sui problemi rilevati.
Figura 5. Finestra di dialogo Elimina
- Seleziona Visualizza utilizzi per controllare quali elementi verranno eliminati. L'eliminazione Trova sicura
La finestra di dialogo Conflitti mostra tutti gli utilizzi che non è sicuro eliminare, quindi
puoi modificare il codice corrispondente.
Figura 6. Utilizzi non sicuri
- Fai clic con il tasto destro del mouse su un utilizzo per visualizzare il menu contestuale, quindi seleziona Vai all'origine puoi apportare le modifiche necessarie.
- Nel riquadro Trova conflitti di eliminazione sicura, seleziona Esegui di nuovo eliminazione sicura per assicurati che non ci siano altri utilizzi che richiedono attenzione.
- Una volta eliminati gli utilizzi, fai clic su Esegui il refactoring per eliminare la chiave.
Correggi errori
La figura 7 mostra l'Editor delle traduzioni che mostra i contenuti di inglese, spagnolo,
e francese
strings.xml
file. Il testo rosso indica le righe che contengono errori.
![](https://developer.android.com/static/studio/images/write/translations-editor_2x.png?authuser=0000&hl=it)
Figura 7. Il testo rosso indica una condizione di errore che deve correggere
Per correggere un errore, passa il mouse sopra il testo rosso per visualizzare una spiegazione del problema e del relativo risoluzione del problema.
Quando apporti modifiche nell'Editor traduzioni, lo stato sottostante
strings.xml
file vengono aggiornati con le modifiche. Quando effettui
modifiche in un file strings.xml
, la colonna corrispondente nell'Editor traduzioni
con le tue modifiche.
Esempi di correzioni dell'Editor traduzioni:
- La figura 7 mostra che per la riga app_name è selezionata l'opzione Untranslatable, ma è una traduzione in spagnolo fornita. Elimina la traduzione in spagnolo per correggere l'errore.
- La figura 7 mostra che nella riga next_page manca una traduzione in francese. Utilizza il tuo per copiare Page Suivante nella cella in modo da correggere l'errore. Copia e incolla da tastiera copia il testo con i segni diacritici nella cella.
Visualizza il testo tradotto nell'Editor di progettazione
Per vedere come viene visualizzato il testo tradotto nel layout della tua app, attiva/disattiva la il testo tra la versione predefinita e la versione tradotta in Design Editor, come segue:
- Nella sezione Progetto > Nel riquadro Android a sinistra, seleziona ModuleName > res > layout.
- Fai doppio clic su content_main.xml per aprirlo e modificarlo.
- Fai clic sulla scheda Design nell'angolo in basso a sinistra per visualizzare l'Editor di Design.
- In Design Editor, seleziona la Lingua
Elenco a discesa
.
- Seleziona Modifica traduzioni
.
- Seleziona la lingua che vuoi utilizzare per visualizzare l'app.
Figura 8. L'elenco a discesa delle lingue con lo spagnolo selezionato
Design Editor mostra il layout dell'app nella lingua selezionata, che in questo caso è Spagnolo.
![](https://developer.android.com/static/studio/images/write/spanish-translation_2x.png?authuser=0000&hl=it)
Figura 9. Design Editor che mostra il testo tradotto in Spagnolo
Imposta Design Editor sulla lingua predefinita
Per ripristinare la lingua predefinita, seleziona es > Lingua
.
![](https://developer.android.com/static/studio/images/write/changelanguage_2x.png?authuser=0000&hl=it)
Figura 10. Imposta la lingua predefinita
Gestire e testare il testo localizzabile
La piattaforma Android e Android Studio offrono diverse funzionalità utili per la gestione e il test la tua app localizzabile testo. Queste funzioni offrono opzioni utili per risolvere i problemi relativi agli script da destra a sinistra (RTL), come l'arabo o l'ebraico. Il test del testo localizzabile ti consente di apportare modifiche all'interfaccia utente il testo e il relativo layout prima di eseguire il commit dei messaggi nel repository di origine per l'invio la traduzione in un secondo momento.
Esegui il refactoring del progetto per il supporto RTL
Android Studio include un comando di refactoring che consente il supporto del testo bidirezionale
in TextView
,
ConstraintLayout
e
LinearLayout
elementi quindi
le tue app possono visualizzare e consentire agli utenti di modificare il testo sia nella scrittura da sinistra a destra (LTR) che da destra a sinistra
(RTL). Il comando fornisce anche il mirroring automatico dei layout dell'interfaccia utente delle app e di tutte le visualizzazioni
widget. Per vedere la modifica della direzione del testo e il mirroring del layout, devi impostare anche il valore
proprietà direzioni di testo e layout
nell'editor del layout.
La procedura seguente mostra come eseguire il refactoring del progetto per il supporto RTL:
- Seleziona Refactoring > Se possibile, aggiungi il supporto RTL per visualizzare la finestra di dialogo mostrata in
figura 11.
Figura 11. Aggiungi il supporto RTL
- Se l'elemento
<application>
nel tuoAndroidManifest.xml
file non hanno l'attributoandroid:supportsRTL="true"
, quindi seleziona la casella di controllo Update AndroidManifest.xml. - Se il valore
targetSdkVersion
della tua app ha almeno 17 anni, seleziona Sostituisci le proprietà sinistra/destra con le proprietà inizio/fine. In questo le proprietà devono utilizzare "start" e "end" al posto di "sinistra" e "destra". Per ad esempio,android:paddingLeft
diventaandroid:paddingStart
. - Se la tua app
targetSdkVersion
ha meno di 16 anni, seleziona Genera versioni -v17 In questo caso, il file XML deve utilizzare entrambi gli insiemi di proprietà. Ad esempio, nel file XML devono essere utilizzatiandroid:paddingLeft
eandroid:paddingStart
.
- Se l'elemento
- Per visualizzare la finestra Trova anteprima del refactoring, fai clic su Esegui.
Figura 12. Controlla l'anteprima
- Fai clic su Esegui il refactoring.
Per ulteriori informazioni sul refactoring del progetto per il supporto RTL, vedi Supporto nativo per RTL in Android 4.2.
Proprietà di direzione del testo e del layout
La finestra Proprietà a destra indica la proprietà textDirection da utilizzare con widget di testo e la proprietà layoutDirection da utilizzare con i widget di layout per cambiare la direzione dei componenti di testo e layout. Le proprietà delle direzioni sono elencate nella finestra Proprietà a destra e lavorare con le API di livello 17 o superiore.
Per vedere la modifica della direzione del testo e il mirroring del layout, devi anche esegui il refactoring del progetto per il supporto RTL. In inglese, la direzione del testo modifica sposta solo la punteggiatura dal lato destro a a sinistra del testo; ad esempio, "Hello World!" diventa "!Hello World". Per visualizzare il testo LTR se passi a RTL, devi usare una lingua RTL nell'app. Se vuoi usare l'inglese e vedere il passaggio di testo a RTL a scopo di test, usa pseudolocales. Gli pseudolocale sono indipendenti dal comando di refactoring e dalle proprietà delle direzioni.
Per accedere alle proprietà delle direzioni e utilizzarle:
- Nell'Editor layout, seleziona un widget per il testo.
- Apri la finestra Proprietà e cerca la proprietà RTL che vuoi utilizzare.
Per impostare il valore della proprietà, seleziona una delle seguenti opzioni:
- firstStrong: valore predefinito per la vista principale. Il primo carattere direzionale forte determina la direzione del paragrafo. Se non è presente un carattere direzionale significativo, la direzione del paragrafo è la direzione del layout risolta della vista.
- anyRtl: la direzione del paragrafo è RTL se contiene qualsiasi carattere RTL di grande valore. altrimenti è LTR se contiene caratteri LTR potenti. In caso contrario, la direzione del paragrafo è la direzione del layout risolta della vista.
- ltr: la direzione del paragrafo è LTR.
- rtl: la direzione del paragrafo è RTL.
- locale: la direzione del paragrafo proviene dalle impostazioni internazionali del sistema.
- Eredita: valore predefinito. Utilizza la direzione impostata nel file principale.
- Per rivedere il testo e il layout invertiti, esegui l'app.
Pseudolocale
Uno pseudolocale è un'impostazione internazionale simulata progettata per assumere le caratteristiche di una lingua che causano UI, layout, RTL e altri problemi di traduzione durante la traduzione di un'app. Gli pseudolocale offrono traduzioni istantanee e automatiche leggibili in inglese per tutti i messaggi localizzabili. Questo consente di rilevare i messaggi non traducibili nel codice sorgente.
Per informazioni su come utilizzare gli pseudolocale, consulta Prova La tua app con pseudolocales.