Testare l'app con pseudolocali

Uno pseudolocale è un'impostazione internazionale progettata per simulare le caratteristiche delle lingue che causano problemi di interfaccia utente, layout e altri problemi relativi alla traduzione quando un'app viene tradotta. Gli pseudolocali sono creati da traduzioni istantanee e automatiche leggibili in inglese per tutti i messaggi localizzabili. Il testo non pseudolocalizzato rimanda a messaggi non traducibili nel codice sorgente.

Gli pseudolocali consentono di risparmiare tempo e denaro perché puoi apportare modifiche al testo dell'interfaccia utente e al suo layout prima di eseguire il commit dei messaggi nel repository di codice sorgente, affinché vengano inviati per la traduzione in un secondo momento. Per un elenco di potenziali problemi di traduzione, consulta la sezione Individuare i problemi di localizzazione.

Figura 1. Pseudolocale in inglese (XA).

I nomi pseudolocali di Android seguono le convenzioni di denominazione internazionali standard e i relativi ID possono essere analizzati da qualsiasi linguaggio di programmazione conforme allo standard BCP 47. In questo senso, gli pseudolocali sono come qualsiasi altro paese, ad esempio francese, cinese o russo.

La piattaforma Android fornisce i seguenti due pseudolocali per rappresentare le lingue con scrittura da sinistra a destra (LTR) e da destra a sinistra (RTL):

Figura 2. Pseudolocale AR (XB).

Inglese (XA): aggiunge accenti latini al testo di base dell'interfaccia utente inglese, espande il testo originale aggiungendo testo non accentato e racchiudi ogni unità di messaggio tra parentesi per esporre potenziali problemi del testo espanso. I problemi potenziali possono essere l'interruzione del layout e la sintassi dei messaggi non corretta, ad esempio una suddivisione di frase in più parti visualizzate come più messaggi tra parentesi. Lo pseudolingua inglese (XA) è mostrato nella figura 1.

AR (XB): imposta la direzione del testo dei messaggi originali da sinistra a destra nella direzione da destra a sinistra, in modo da invertire l'ordine dei caratteri nel messaggio originale. Lo pseudolocale AR (XB) è mostrato nella figura 2.

Gli pseudolocali possono aiutarti a creare una versione RTL della tua app, anche se non scrivi o parli nessuna lingua RTL.

Abilita pseudolocali

Le pseudolocali vengono in genere aggiunte alle build orientate agli sviluppatori. Quando scegli una pseudolingua sul tuo dispositivo, tutte le app che supportano gli pseudolocali assumono le caratteristiche dello pseudolocale selezionato, incluse tutte le app di sistema, come l'app Impostazioni e il riquadro Impostazioni rapide.

Per utilizzare le pseudo regioni di Android, devi aver installato Android 4.3 (livello API 18) o versioni successive e avere attivato le opzioni sviluppatore sul dispositivo.

La seguente procedura spiega come abilitare gli pseudolocali:

  1. In Android Studio, attiva le pseudolocali per un'app specifica aggiungendo la seguente configurazione al file build.gradle:

    Trendy

    android {
       ...
       buildTypes {
           debug {
               pseudoLocalesEnabled true
           }
       }
    }
    

    Kotlin

    android {
       ...
       buildTypes.getByName("debug") {
           isPseudoLocalesEnabled = true
       }
    }
    
  2. Crea ed esegui la tua app.

    Figura 3. Seleziona uno pseudolocale.

  3. Utilizza l'app Impostazioni per selezionare uno pseudolocale. Questo passaggio varia in base alla versione di Android, come indicato di seguito:

    Android 5.0 (livello API 21) o versioni successive

    1. Sul dispositivo, apri l'app Impostazioni e tocca Lingue e immissione > Preferenze di lingua.
    2. Nell'elenco Preferenze lingua, trascina la scheda per spostare uno pseudolinguaggio in cima all'elenco e impostarlo come lingua attiva. Vedi la figura 3.

    Android 4.4.4 (livello API 19) o versioni precedenti

    1. Sul dispositivo, apri l'app Impostazioni e tocca Lingue e immissione > Preferenze lingua > Aggiungi una lingua.
    2. Tocca uno pseudolinguaggio per aggiungerlo all'elenco Preferenze lingua.
    3. Nell'elenco Preferenze lingua, trascina la scheda per spostare uno pseudolinguaggio in cima all'elenco e impostarlo come lingua attiva. Vedi la figura 3.

Individua i problemi di localizzazione

Gli pseudolocali offrono un modo efficace e rapido per individuare potenziali problemi di localizzazione nell'interfaccia utente, aiutandoti a identificare i problemi nelle seguenti aree:

  • Le stringhe hardcoded, che non possono essere inviate alla traduzione, vengono visualizzate come testo non accentato nello pseudolocale per renderle visibili.
  • Problemi di layout dell'interfaccia utente causati dall'espansione del testo, che mostrano i punti in cui l'interfaccia utente può interrompersi a causa della lunghezza del testo.
  • Concatenazione di stringhe, visualizzata come un messaggio suddiviso su due o più parentesi. Questo può complicare la traduzione corretta, perché i traduttori devono tradurre ogni parte in modo indipendente, senza sapere che le parti sono correlate. La concatenazione di stringhe può inoltre rendere impossibile la traduzione corretta, perché lingue diverse potrebbero richiedere un ordine diverso delle parti o una struttura delle frasi completamente diversa. Lingue come giapponese, coreano e tamil posizionano il verbo alla fine di una frase. Quando una frase è concatenata, i traduttori non possono modificare l'ordine delle parole a seconda delle necessità.

  • Problemi di testo bidirezionali (bidI), ad esempio quando i contenuti in una direzione di testo includono una frase in linea nella direzione opposta del testo, rendendo la stringa difficile da leggere.

  • Problemi da destra a sinistra (RTL), ad esempio elementi che non vengono speculari. Alcuni esempi sono: un elemento dell'interfaccia utente che non si sposta a sinistra, testo che non si inverte e che si sposta a sinistra o punteggiatura in posizione errata, come "pseudolocales rules!" che si modifica in "elur selacoloduesp!" anziché "!elur selacoloduesp".