Dokumentation / Übersetzen / Android strings.xml
Android strings.xml übersetzen
Übersetzen Sie res/values/strings.xml in values-<lang>-Ordner, wobei %1$s-Argumente, <plurals>, <xliff:g> und Apostrophen-Escaping behandelt und translatable="false"-Strings übersprungen werden.
Funktionsweise
localize-dev translate liest res/values/strings.xml oder Compose Multiplatforms composeResources/values/ und schreibt values-ru/strings.xml, values-pt-rBR/strings.xml und den Rest. Mit translatable="false" markierte Strings werden weggelassen, und der XML-Kommentar über einem String wird dem Modell als Kontext übergeben.
Text wird vor der Übersetzung entschlüsselt und danach wieder verschlüsselt, sodass You\'ve gültig bleibt und ein Apostroph in einer französischen oder italienischen Übersetzung den Build nicht unterbricht. CDATA bleibt CDATA.
Vorher und nachher
Reale Ausgabe von localize-dev translate --locales ru in der ersten Datei. Russisch benötigt few und many, der App-Name wird nicht übersetzt und der <xliff:g>-Span bleibt wie geschrieben erhalten.
<?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>Was intakt bleibt
%1$s,%dund andere Formatargumente, geprüft<xliff:g>Spans, exakt wie geschrieben beibehalten<plurals>mit den Mengen, die jede Sprache verwendet- Inline-Markup wie
<b>und CDATA, wo es in der Quelle vorhanden ist
Häufige Fehler und wie sie vermieden werden
Nicht maskierte Apostrophe
„l’application“ muss in strings.xml als l\'application geschrieben werden, sonst schlägt der Ressourcenkompilierer den Build fehl. Jede Übersetzung wird beim Einfügen in die Datei maskiert.
Fehlende Mengen
Russisch, Polnisch und Arabisch verwenden few und many. Mit nur one und other fällt getQuantityString für Zählungen wie 3 auf other zurück, und die Grammatik ist falsch.
Übersetzen, was bleiben soll
App-Namen und <xliff:g>-Inhalte, wie z. B. ein Produktname oder eine Variable, werden oft übersetzt. translatable="false"-Strings werden übersprungen, und <xliff:g>-Spans werden maskiert, damit das Modell sie nie als Text sieht.
Ausführen
In dem Ordner, der Ihre Lokalisierungsdateien enthält. Sprachen ohne eine Datei erhalten eine. --dry-run zeigt, was sich zuerst ändern würde.
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,deDann halten Sie es in der CI vollständig. Dies erfordert keinen API-Schlüssel und schlägt fehl, wenn eine Sprache Übersetzungen vermisst:
npx localize-dev check --only translationsKostenlos für 1.000 Strings pro Monat. Ein String zählt einmal, egal in wie viele Sprachen er übersetzt wird. Erstellen Sie ein kostenloses Konto
Anleitungen für Apps, die dieses Format verwenden
Wenn der Text noch fest in Ihrem Code codiert ist, verschiebt localize-dev run ihn zuerst in dieses Format.