Traduire

Traduire strings.xml d'Android sans casser %1$s

Un values-de/strings.xml qui a perdu un <b> ou utilise %2$s deux fois compile quand même. Ci-dessous, une commande trouve ces lignes et un pluriel manquant, une autre retraduit le fichier.

KAERIS a traduit cette page et vérifié chaque ligne en la retraduisant. Un locuteur natif ne l'a pas encore revue. Original anglais

Le projet d'exemple

Un petit projet Android strings.xml : la source anglaise et un fichier allemand en retard. Les commandes ci-dessous ont tourné exactement sur ces fichiers.

Sourceres/values/strings.xml
<resources>
    <string name="app_name" translatable="false">Tasky</string>
    <string name="welcome">Welcome back, %1$s!</string>
    <string name="due">Due %1$s at %2$s</string>
    <string name="tap_here">Tap <b>here</b> to continue</string>
    <plurals name="tasks_left">
        <item quantity="one">%d task left</item>
        <item quantity="other">%d tasks left</item>
    </plurals>
    <string name="sign_out">Sign out</string>
</resources>
Allemand, avantres/values-de/strings.xml
<resources>
    <string name="welcome">Willkommen zurück, %s!</string>
    <string name="due">Fällig am %2$s um %2$s</string>
    <string name="tap_here">Tippe hier, um fortzufahren</string>
    <string name="sign_out">Abmelden</string>
</resources>

1. Trouver ce qui manque

kaeris check compare chaque traduction au fichier source. Il fonctionne hors ligne, sans clé ni compte, et se termine avec le code 1 s'il trouve un problème : un job de CI peut donc s'y arrêter.

Terminalexit code 1
$ npx kaeris check --source res/values/strings.xml --langs de
✗ de: 1 missing key(s): tasks_left (plural)
✗ de: 2 placeholder mismatch(es):
    welcome: missing ['%1$s'], added ['%s']
    due: missing ['%1$s'], added -
✗ de: 6 translation fault(s):
    welcome: lost placeholder %1$s
    welcome: invented placeholder %s (not in source)
    due: lost placeholder %1$s
    due: placeholder %2$s appears 2× vs 1× in source (duplicated)
    tap_here: lost inline tag </b>
    tap_here: lost inline tag <b>
✗ 1 missing key, 2 placeholder mismatches, 6 translation faults

2. Traduire le fichier

--only-new couvre JSON et ARB dans cette version. Pour strings.xml, la CLI le signale et retraduit tout le fichier, ce qui remplace aussi les lignes cassées. La commande fait partie du paquet Python : pip install kaeris.

Terminalexit code 0
$ kaeris translate res/values/strings.xml --langs de --only-new
→ no key: free demo limits 10,000 chars per file, 8 languages per run, get a key: kaeris.dev/developer
! --only-new supports JSON/ARB only (zero-dependency CLI); translating the whole .xml file instead
→ Translating strings.xml → de
✓ Wrote 1 file(s) to ./res/values-de
res/values-de/strings.xml
✓ Translation QA: no placeholder loss, no overflow risks
→ Run: openai/gpt-6-luna · Free · 1/1 languages · 6 strings · 5.7s
     95 charged
Allemand, aprèsres/values-de/strings.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- Generated by KAERIS i18n Tool — de -->
<resources>
    <string name="welcome">Willkommen zurück, %1$s!</string>
    <string name="due">Fällig am %1$s um %2$s</string>
    <string name="tap_here">Tippe <b>hier</b>, um fortzufahren</string>
    <plurals name="tasks_left">
        <item quantity="one">%d Aufgabe übrig</item>
        <item quantity="other">%d Aufgaben übrig</item>
    </plurals>
    <string name="sign_out">Abmelden</string>
</resources>

3. Vérifier à nouveau

Code de sortie 0 : toutes les clés sont là et chaque placeholder correspond à la source.

Terminalexit code 0
$ npx kaeris check --source res/values/strings.xml --langs de
✓ de: complete & placeholder-safe
✓ all locales complete & placeholder-safe

Exécuté le 2 novembre 2026 avec l'offre gratuite, sans clé : npx kaeris 0.2.42 pour la vérification, kaeris 0.2.42 depuis PyPI pour la traduction. Sortie telle qu'imprimée, sans les lignes de progression ni le chemin du dossier local.

Ce que kaeris check détecte dans Android strings.xml

Ce que ça coûte

Questions

Que devient translatable="false" ?

Ces chaînes restent à l'écart : la vérification ne les exige pas et la traduction ne les contient pas, comme app_name ci-dessus.

Le XML est-il sûr à analyser ?

Oui. Les fichiers avec un DOCTYPE ou des entités externes sont refusés avant l'analyse.

Peut-il s'exécuter en CI ?

Oui. npx kaeris check se termine avec le code 1 s'il trouve un problème. Recettes : GitHub Actions, GitLab CI, pre-commit.

Continuer

Référence de check · Référence de la CLI · Vérification gratuite dans le navigateur · Traduire dans le navigateur

Autres stacks : react-i18next · next-intl · vue-i18n · Flutter · iOS