Docs / Traduire / Android strings.xml
Traduire Android strings.xml
Traduisez res/values/strings.xml dans les dossiers values-<lang>, avec les arguments %1$s, <plurals>, <xliff:g> et l'échappement des apostrophes gérés, et les chaînes translatable="false" ignorées.
Comment ça marche
localize-dev translate lit res/values/strings.xml, ou composeResources/values/ de Compose Multiplatform, et écrit values-ru/strings.xml, values-pt-rBR/strings.xml et le reste. Les chaînes marquées translatable="false" sont omises, et le commentaire XML au-dessus d'une chaîne est transmis au modèle comme contexte.
Le texte est déséchappé avant la traduction et rééchappé après, de sorte que You\'ve reste valide et qu'une apostrophe dans une traduction française ou italienne ne casse pas la compilation. CDATA reste CDATA.
Avant et après
Sortie réelle de localize-dev translate --locales ru sur le premier fichier. Le russe a besoin de few et many, le nom de l'application n'est pas traduit, et la balise <xliff:g> est conservée telle quelle.
<?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><?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>Ce qui reste intact
%1$s,%det autres arguments de format, vérifiés<xliff:g>spans, conservés tels quels<plurals>avec les quantités utilisées par chaque langue- Balises inline comme
<b>, et CDATA là où la source en a
Erreurs courantes et comment elles sont évitées
Apostrophes non échappées
« l’application » doit être écrit l\'application dans strings.xml, sinon le compilateur de ressources échoue la compilation. Chaque traduction est échappée lors de son insertion dans le fichier.
Quantités manquantes
Le russe, le polonais et l'arabe utilisent few et many. Avec seulement one et other, getQuantityString se rabat sur other pour des comptes comme 3, et la grammaire est incorrecte.
Traduire ce qui doit rester
Les noms d'applications et le contenu <xliff:g>, tels qu'un nom de produit ou une variable, sont souvent traduits. Les chaînes translatable="false" sont ignorées et les spans <xliff:g> sont masqués pour que le modèle ne les voie jamais comme du texte.
Exécuter
Dans le dossier qui contient vos fichiers de langue. Les langues sans fichier en obtiennent un. --dry-run montre ce qui changerait en premier.
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,deEnsuite, gardez-le complet dans la CI. Cela ne nécessite pas de clé API et échoue lorsqu'une langue manque de traductions :
npx localize-dev check --only translationsGratuit pour 1 000 chaînes par mois. Une chaîne compte une fois, peu importe dans combien de langues elle va. Créez un compte gratuit
Guides pour les applications qui utilisent ce format
Lorsque le texte est encore codé en dur dans votre code, localize-dev run le déplace d'abord dans ce format.