localize.dev

Documenti / Traduci / Android strings.xml

Traduci Android strings.xml

Traduci res/values/strings.xml in cartelle values-<lang>, con argomenti %1$s, <plurals>, <xliff:g> e escape dell'apostrofo gestiti, e stringhe translatable="false" saltate.

Come funziona

localize-dev translate legge res/values/strings.xml, o composeResources/values/ di Compose Multiplatform, e scrive values-ru/strings.xml, values-pt-rBR/strings.xml e il resto. Le stringhe contrassegnate con translatable="false" vengono omesse e il commento XML sopra una stringa viene inviato al modello come contesto.

Il testo viene spacchettato prima della traduzione e nuovamente spacchettato dopo, in modo che You\'ve rimanga valido e un apostrofo in una traduzione francese o italiana non interrompa la build. CDATA rimane CDATA.

Prima e dopo

Output effettivo di localize-dev translate --locales ru sul primo file. Il russo richiede few e many, il nome dell'app non viene tradotto e lo span <xliff:g> viene mantenuto così com'è scritto.

res/values/strings.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="app_name" translatable="false">Trailmap</string>
    <!-- Shown on the home screen above the list of trails -->
    <string name="home_title">Trails near you</string>
    <string name="saved_trail">You\'ve saved %1$s to <xliff:g id="list">%2$s</xliff:g></string>
    <plurals name="trails_found">
        <item quantity="one">%d trail found</item>
        <item quantity="other">%d trails found</item>
    </plurals>
</resources>
res/values-ru/strings.xml · russo
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="home_title">Трейлы рядом с вами</string>
    <string name="saved_trail">Вы сохранили %1$s в <xliff:g id="list">%2$s</xliff:g></string>
    <plurals name="trails_found">
        <item quantity="one">%d трейл найден</item>
        <item quantity="few">%d трейла найдено</item>
        <item quantity="many">%d трейлов найдено</item>
        <item quantity="other">%d трейлов найдено</item>
    </plurals>
</resources>

Cosa rimane intatto

  • %1$s, %d e altri argomenti di formato, verificati
  • <xliff:g> span, mantenuti esattamente come scritti
  • <plurals> con le quantità utilizzate da ciascuna lingua
  • Markup inline come <b>, e CDATA dove presente nell'origine

Errori comuni e come vengono evitati

Apostrofi non preceduti da escape

“l’application” deve essere scritto l\'application in strings.xml, altrimenti il compilatore delle risorse non riuscirà la build. Ogni traduzione viene sottoposta a escape durante l'inserimento nel file.

Quantità mancanti

Il russo, il polacco e l'arabo usano few e many. Con solo one e other, getQuantityString ripiega su other per conteggi come 3, e la grammatica è errata.

Tradurre ciò che deve rimanere

I nomi delle app e i contenuti <xliff:g>, come il nome di un prodotto o una variabile, vengono spesso tradotti. Le stringhe translatable="false" vengono saltate e gli span <xliff:g> vengono mascherati in modo che il modello non li veda mai come testo.

Esegui

Nella cartella che contiene i file di localizzazione. Le lingue senza un file ne ottengono uno. --dry-run mostra cosa cambierebbe per primo.

npx localize-dev login

# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,de

Quindi tienilo completo in CI. Non richiede alcuna chiave API e fallisce quando a una lingua mancano le traduzioni:

npx localize-dev check --only translations

Gratuito per 1000 stringhe al mese. Una stringa conta una volta, indipendentemente da quante lingue includa. Crea un account gratuito

Guide per le app che utilizzano questo formato

Quando il testo è ancora hardcoded nel tuo codice, localize-dev run lo sposta prima in questo formato.