Localizzare l'interfaccia utente con l'editor di traduzioni

L'Editor traduzioni offre una visualizzazione consolidata e modificabile di tutte le tue risorse stringa predefinite e tradotte.

Per un'introduzione alla traduzione della tua app in diverse lingue, leggi Supporta lingue e culture diverse.

L'Editor delle traduzioni che mostra il testo dell'app prima della traduzione.
Figura 1. Editor delle traduzioni che mostra il testo dell'app prima della traduzione

Risorse stringa

Le risorse stringa di un progetto sono contenute nei file strings.xml. Il tuo progetto ha un file strings.xml predefinito che contiene risorse stringa nella lingua predefinita della tua app, ovvero la lingua che prevedi venga parlata dalla maggior parte degli utenti della tua app. Puoi anche avere file strings.xml tradotti che contengono risorse stringa per altre lingue che vuoi che la tua app supporti.

Una volta completato il file strings.xml predefinito, puoi aggiungere le traduzioni autonomamente o pagare un servizio professionale per eseguirle. In entrambi i casi, dovresti sfruttare le funzionalità di Android Studio per gestire e testare il testo localizzabile. Per informazioni sui servizi di traduzione professionale, consulta Servizi di traduzione.

Apri l'editor delle traduzioni

Puoi accedere all'Editor di traduzioni dalle seguenti posizioni in Android Studio.

Apri dalla visualizzazione Android

  1. Nel riquadro Progetto > Android a sinistra, seleziona ModuleName > res > values.
  2. Fai clic con il tasto destro del mouse sul file strings.xml e seleziona Open Translations Editor (Apri Editor traduzioni).

    L'Editor traduzioni mostra le coppie chiave-valore del file strings.xml.

La Figura 1 mostra il testo predefinito dell'app (in questo caso, in inglese) nell'Editor di traduzioni per un'app prima che venga eseguito il lavoro di traduzione. I contenuti dei file strings.xml tradotti verranno visualizzati a destra della colonna Non traducibile con una colonna per lingua, come mostrato nella figura 2.

Apri da strings.xml

Puoi accedere all'Editor di traduzioni da qualsiasi file strings.xml.

  1. Nel riquadro Progetto > Android a sinistra, seleziona ModuleName > res > values.
  2. Fai doppio clic su strings.xml per aprirlo e modificarlo.
  3. In strings.xml, fai clic sul link Open editor (Apri editor) nell'angolo in alto a destra.

Configura le righe non traducibili

Nell'Editor traduzioni, puoi selezionare Non traducibile per indicare che non vuoi che il testo di questa riga venga tradotto. Il testo che non vuoi tradurre potrebbe essere specifico del prodotto, come nomi commerciali e marchi, o termini tecnici che non hanno una traduzione.

Quando selezioni Non traducibile, la riga corrispondente nel file strings.xml predefinito aggiunge translatable="false". Nell'esempio seguente, EasyApp nella riga superiore non viene 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>

Aggiungi ed elimina lingue

L'Editor traduzioni supporta BCP 47 e combina i codici delle impostazioni internazionali e della regione (paese) in un'unica selezione per localizzazioni mirate. Un'impostazione internazionale non definisce solo la lingua. Le impostazioni internazionali includono la formattazione specifica per il paese per elementi come data e ora, valute e decimali.

Per aggiungere una lingua:

  1. Nell'Editor traduzioni, fai clic sull'icona a forma di globo .
  2. Dall'elenco a discesa, seleziona la lingua che vuoi aggiungere.

    La nuova lingua viene visualizzata nell'Editor traduzioni e al progetto viene aggiunta una cartella values-* con un file strings.xml. Ad esempio, values-es per lo spagnolo.

Per eliminare una lingua:

Puoi eliminare una lingua nell'Editor traduzioni eliminando ogni valore nella colonna (consulta Modifica, aggiungi ed elimina testo) oppure puoi eliminare la cartella del progetto per quella lingua, come segue:

  1. Nel riquadro Progetto > Android a sinistra, seleziona ModuleName > res.
  2. Fai clic con il tasto destro del mouse sulla cartella values-* della lingua che vuoi eliminare. Ad esempio, values-hi per l'hindi.
  3. Dall'elenco, seleziona Elimina per eliminare la cartella e il relativo file strings.xml.

Modifica, aggiungi ed elimina testo

Puoi intervenire sulle impostazioni del testo direttamente nel file strings.xml o tramite l'Editor di traduzioni. Questa sezione descrive l'approccio dell'Editor delle traduzioni. Nell'Editor delle traduzioni, puoi modificare, aggiungere o eliminare il testo tramite la visualizzazione elenco o il campo Traduzione nella parte inferiore dell'Editor delle traduzioni.

Visualizzazione elenco in alto e campo Traduzione in basso.
Figura 2. Visualizzazione elenco in alto e campo Traduzione in basso

Visualizzazione elenco

Per modificare o aggiungere testo:

  1. Fai doppio clic sulla cella in cui vuoi modificare o aggiungere testo.
  2. Esegui un'operazione di copia e incolla con la tastiera o, se hai una tastiera che supporta i segni diacritici, digita direttamente nella visualizzazione elenco.
  3. Premi Tab o sposta il cursore fuori dal campo.

Per eliminare il testo:

  1. Fai doppio clic sulla cella che vuoi eliminare.
  2. Nella visualizzazione elenco, seleziona il testo e premi Elimina.
  3. Premi Tab o sposta il cursore fuori dal campo.

Campo di traduzione

Per modificare o aggiungere testo:

  1. Nella visualizzazione elenco, fai clic una volta sulla cella in cui vuoi modificare o aggiungere testo.
  2. Nel campo Traduzione, copia e incolla con la tastiera oppure, se hai una tastiera che supporta i segni diacritici, digita direttamente nel campo Traduzione.
  3. Premi Tab o sposta il cursore fuori dal campo.

Per eliminare il testo:

  1. Fai clic una volta sulla cella che vuoi eliminare.
  2. Nel campo Traduzione, seleziona il testo e premi Elimina.

Aggiungi ed elimina chiavi

Nell'Editor traduzioni, la colonna Chiave elenca gli identificatori univoci per ogni elemento dati nei file strings.xml. Puoi aggiungere ed eliminare le chiavi tramite l'editor delle traduzioni. Quando elimini una chiave, l'Editor traduzioni la elimina insieme a tutte le traduzioni associate. L'Editor traduzioni utilizza il refactoring Safe Delete per eliminare una chiave, in modo da sapere se il testo della chiave è utilizzato altrove e avere la possibilità di apportare le modifiche necessarie prima di eliminare la chiave. Il refactoring di eliminazione sicura garantisce che il codice venga comunque compilato dopo l'eliminazione della chiave.

Per aggiungere una chiave, procedi nel seguente modo:

  1. Nell'Editor traduzioni, fai clic su Aggiungi chiave .
  2. Nella finestra di dialogo, inserisci un nome chiave, un valore predefinito e la posizione del file strings.xml predefinito.

    Finestra di dialogo Aggiungi chiave nell'Editor di traduzioni.
    Figura 3. Aggiungi una chiave

Per eliminare una chiave:

  1. Nell'Editor traduzioni, seleziona la chiave che vuoi eliminare.
  2. Fai clic su Rimuovi chiavi .
  3. Nella finestra di dialogo Elimina, decidi se vuoi un'eliminazione sicura e se vuoi eseguire la ricerca nei commenti e nelle stringhe, quindi fai clic su Ok.

    Finestra di dialogo Elimina chiave nell'Editor delle traduzioni.
    Figura 4. Finestra di dialogo Elimina

    Se non sono presenti riferimenti (utilizzi) alla chiave eliminata o se tutti i riferimenti possono essere compressi in modo sicuro, la chiave viene eliminata. In caso contrario, l'editor delle traduzioni visualizza la finestra di dialogo Utilizzi rilevati con informazioni sui problemi rilevati.

    Finestra di dialogo Utilizzi rilevati nell'editor delle traduzioni.
    Figura 5. Finestra di dialogo Utilizzi rilevati
  4. Seleziona Visualizza utilizzi per esaminare gli elementi che verranno eliminati. La finestra di dialogo Find Safe Delete Conflicts mostra tutti gli utilizzi che non è sicuro eliminare, in modo che tu possa modificare il codice corrispondente.

    Finestra di dialogo Trova conflitti di eliminazione sicura che mostra gli utilizzi non sicuri.
    Figura 6. Utilizzi non sicuri
  5. Fai clic con il tasto destro del mouse su un utilizzo per visualizzare il menu contestuale e seleziona Passa all'origine per apportare le modifiche necessarie.

  6. Nel riquadro Trova conflitti di eliminazione sicura, seleziona Esegui di nuovo l'eliminazione sicura per assicurarti che non ci siano altri utilizzi che richiedono attenzione.

  7. Una volta ripuliti gli utilizzi, fai clic su Do Refactor (Rifattorizza) per eliminare la chiave.

Correggi gli errori

La Figura 7 mostra l'Editor di traduzioni che visualizza i contenuti dei file strings.xml in inglese, francese e spagnolo. Il testo rosso indica le righe che contengono errori.

Editor delle traduzioni che mostra gli errori in rosso.
Figura 7. Il testo rosso indica una condizione di errore che devi correggere

Per correggere un errore, passa il mouse sopra il testo rosso per visualizzare una spiegazione del problema e della relativa risoluzione.

Quando apporti modifiche nell'Editor delle traduzioni, i file strings.xml sottostanti vengono aggiornati con le modifiche. Quando apporti modifiche a un file strings.xml, la colonna corrispondente nell'Editor di traduzioni viene aggiornata con le modifiche.

Esempi di correzioni dell'Editor delle traduzioni:

  • La Figura 7 mostra che la riga app_name è contrassegnata come Untranslatable, ma è presente una traduzione in spagnolo. Elimina la traduzione in spagnolo per correggere l'errore.
  • La Figura 7 mostra che nella riga next_page manca una traduzione in francese. Utilizza la tastiera per copiare Page Suivante nella cella per correggere l'errore. Un'operazione di copia e incolla da tastiera copia il testo con eventuali segni diacritici nella cella.

Gestisci e testa il testo localizzabile

La piattaforma Android e Android Studio offrono diverse funzionalità per aiutarti a gestire e testare il testo localizzabile della tua app. Queste funzionalità offrono opzioni per aiutarti a risolvere i problemi relativi agli script con scrittura da destra a sinistra (RTL), come l'arabo o l'ebraico. Il test del testo localizzabile ti consente di apportare modifiche al testo della UI e al suo layout prima di eseguire il commit dei messaggi nel repository di origine per l'invio per la traduzione in un secondo momento.

Supporto delle lingue con scrittura da destra a sinistra

Jetpack Compose gestisce i layout da destra a sinistra (RTL) in modo nativo. I modificatori di layout e le API si basano su concetti direzionali come start e end anziché su direzioni assolute come left e right. Quando la lingua di sistema cambia in un'impostazione internazionale RTL, Compose esegue automaticamente il mirroring di questi layout.

Affinché la tua app riconosca le impostazioni internazionali RTL e attivi questo mirroring, devi eseguire l'attivazione utilizzando il file manifest dell'app.

Per attivare il supporto per le lingue con scrittura da destra a sinistra:

  1. Apri il file AndroidManifest.xml.
  2. Aggiungi l'attributo android:supportsRtl="true" all'elemento <application>:
<manifest ... >
    <application
        ...
        android:supportsRtl="true">
    </application>
</manifest>

Per scoprire di più su come Compose gestisce il layout del testo, il mirroring e le configurazioni RTL personalizzate, consulta Utilizzo delle lingue RTL.

Imposta manualmente la direzione del testo

In Jetpack Compose, non utilizzi una finestra Proprietà visiva per forzare il layout o le direzioni del testo. Compose gestisce automaticamente il mirroring RTL in base alle impostazioni internazionali del sistema.

Tuttavia, se devi eseguire l'override manuale della direzione per un elemento di testo specifico (ad esempio, per visualizzare una stringa LTR in un layout RTL), puoi passare un oggetto TextDirection al tuo TextStyle.

I valori supportati includono:

Per scoprire di più sullo stile del testo e sulla configurazione delle direzioni manuali del testo in Compose, consulta Stile del testo.

Utilizza stringhe localizzate nella tua app

Dopo aver aggiunto e tradotto le stringhe utilizzando l'editor delle traduzioni, i file res/values/strings.xml sottostanti vengono aggiornati automaticamente e puoi utilizzare le risorse localizzate direttamente nella UI.

Per scoprire come visualizzare il testo localizzato, gestire l'RTL in modo nativo e utilizzare @Preview per testare diverse impostazioni internazionali e pseudo-impostazioni internazionali, consulta la sezione Stringhe di Risorse in Compose.

Pseudolocale

Un'impostazione internazionale fittizia è un'impostazione internazionale simulata progettata per assumere le caratteristiche delle lingue che causano problemi di UI, layout, RTL e altri problemi di traduzione quando un'app viene tradotta. Le pseudolocale forniscono traduzioni istantanee e automatiche leggibili in inglese per tutti i messaggi localizzabili. In questo modo, puoi individuare i messaggi non traducibili nel codice sorgente.

Per informazioni su come utilizzare le pseudolocali, consulta Testa l'app con le pseudolocali.

Risorse aggiuntive

Visualizza contenuti