Eine Android-App lokalisieren

Übersetze Android-Ressourcen, lege sie in den richtigen Sprachverzeichnissen ab und überprüfe die Texte in der App.

Android lädt lokalisierte Texte aus Ressourcenverzeichnissen, während der Anwendungscode weiterhin dieselben Ressourcennamen verwendet. Lingo.dev übersetzt diese Ressourcen und legt sie in den Zielverzeichnissen ab. Ein sinnvoller erster Schritt: Nimm eine Begrüßung, eine Liste und eine Pluralressource aus der Standard-Ressourcendatei und zeige sie auf einem Bildschirm an, während die App in einer anderen Sprache läuft.

Verwende dieses Verfahren für natives Android-XML. Für Flutter folge der Anleitung ARB-Ressourcen und generierter Lokalisierungscode, für JSON-Kataloge der Anleitung React Native lokalisieren.

Ressourcen vorbereiten, die der Bildschirm lädt #

Lege die Standardressourcen in app/src/main/res/values/strings.xml ab:

xml
<resources>
  <string name="welcome">Welcome, %1$s!</string>
  <string name="product_name" translatable="false">ExampleApp</string>
  <string-array name="delivery_options">
    <item>Standard delivery</item>
    <item>Express delivery</item>
  </string-array>
  <plurals name="items_count">
    <item quantity="one">%d item</item>
    <item quantity="other">%d items</item>
  </plurals>
</resources>

Binde diese Ressourcen über die vorhandenen Ressourcenaufrufe der Anwendung in den Bildschirm ein. welcome identifiziert den Text; %1$s nimmt den vom Code übergebenen Namen entgegen. Die Pluralressource benötigt die Anzahl zur Auswahl und Formatierung. translatable="false" schließt den Produktnamen von der Übersetzung aus.

Der Android-Dateihandler wählt reine Texteinträge aus und überspringt Einträge mit gemischtem Inline-Markup aus untergeordneten Elementen. Enthält ein Text untergeordnete Elemente wie <b> oder <xliff:g>, berücksichtige diese Einträge separat. CDATA-Text lässt sich übersetzen, ohne die umschließende Struktur zu verändern; darin enthaltenes Markup gilt als Text, nicht als geschützte Struktur untergeordneter Elemente. Überprüfe Ressourcen mit formatierten Inhalten mit dem tatsächlichen Renderer der Anwendung.

Quellauswahl und Sprachpfade konfigurieren #

Installiere und verknüpfe die CLI vom Projektstammverzeichnis aus:

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,pt-BR,zh-Hans --files 'app/src/main/res/values/strings.xml' --yes
lingo link

Behalte in .lingo/config.json die verknüpften IDs der Organisation und der Lokalisierungs-Engine bei und lege dann das Dateiformat explizit fest:

json
{
  "pattern": "app/src/main/res/values/strings.xml",
  "format": "android"
}

Verwende dieses Objekt als Dateieintrag. Die Dateiendung .xml allein reicht nicht aus, um Android von einem anderen XML-Vokabular zu unterscheiden. Füge Quelleinträge für weitere Ressourcendateien wie arrays.xml hinzu, ohne die generierten Zielverzeichnisse einzubeziehen.

Die aktuelle CLI erkennt das Verzeichnis values/ ohne Qualifizierer und erzeugt Android-Qualifizierer für die Zielpfade:

ZielspracheZielverzeichnis
esvalues-es
pt-BRvalues-pt-rBR
zh-Hansvalues-b+zh+Hans

Ein symbolischer Link für values-en ist bei dieser Verzeichnisstruktur nicht nötig. Falls eine ältere Konfiguration einen solchen Link verwendet hat, aktualisiere die Konfiguration und kontrolliere sie, bevor du den Link entfernst. Ein Verzeichnis mit einem einfachen Namen wie values-pt-BR verwendet nicht den erwarteten regionalen Qualifizierer. Unter CLI-Konfiguration findest du Informationen zu expliziten Zielpfaden und zur Schreibweise von Sprachen.

Erste Zielübersetzung erstellen und laden #

Führe für fehlende Zieldateien Folgendes aus:

sh
lingo push --backfill-missing --wait

Warte, bis der Durchlauf einschließlich einer eventuell konfigurierten Prüfung abgeschlossen ist, und sieh dir das abgerufene XML an. Vergleiche Ressourcennamen, Array-Reihenfolge, Mengenattribute, den unveränderten Produktnamen und Formatspezifizierer mit der Quelle. Ohne --wait rufst du den abgeschlossenen Durchlauf mit lingo pull in dem checkout ab, aus dem du ihn eingereicht hast.

Erstelle die App mit der Gradle-Konfiguration des Projekts und führe sie dann auf einem Gerät oder Emulator in einer Zielsprache aus. Öffne den Bildschirm und gib einen Namen sowie verschiedene Anzahlen ein. Ein erfolgreicher Build bestätigt, dass Ressourcensyntax und Referenzen korrekt sind; der Test auf dem Gerät bestätigt, dass Android tatsächlich das übersetzte Verzeichnis ausgewählt hat.

Lies die Ausgabe für Anzahlen, die die Pluralkategorien der Zielsprache abdecken. Der Handler behält die Pluralstruktur der Quelle bei. Die englischen Formen one und other stellen daher nicht sicher, dass alle Formen der Zielsprache vorhanden sind. Überprüfe lange Beschriftungen, Texte für die Barrierefreiheit und bei Bedarf das Layout für die Leserichtung von rechts nach links. lingo check ersetzt keine Kontrollen der Android-Ressourcen oder ihrer Vollständigkeit.

Mit Änderungen an der Quelle fortfahren #

Erstelle einen gemeinsamen Commit mit der Quelle, den akzeptierten Zieldateien, der verknüpften Konfiguration und .lingo/lock.json. Übersetze nach der Bearbeitung der Quelltexte die Änderungen mit:

sh
lingo push --wait

Um nach einer Änderung der Engine-Vorgaben alle Übersetzungen einer Quelldatei neu zu generieren, sichere die akzeptierten Zieldateien und führe Folgendes aus:

sh
lingo push "app/src/main/res/values/strings.xml" --force --wait

Dadurch werden die Übersetzungen der ausgewählten Datei in den konfigurierten Zielsprachen ersetzt. Informationen zur Dateiauswahl und Neugenerierung findest du unter CLI-Geltungsbereiche.

Bewahre einen Vorher-Nachher-Diff der Zieldateien auf. Markiere Android-Ressourcen, die unverändert bleiben sollen, mit translatable="false", wie im obigen Beispiel für den Produktnamen. Sichere vorhandene Korrekturen vor einer Aktualisierung. Um Änderungen an Zieldateien nach der Einreichung zu erkennen, lasse --wait weg und sieh dir lingo pull --dry-run vor dem Abruf an. Übersetzungen nach der Prüfung bewahren erläutert diese Kontrolle und den Umgang mit Konflikten.

Sobald ein Bildschirm funktioniert, nutze die GitHub App oder einen CI-Runner für wiederkehrende Übersetzungen. Der Runner übernimmt die Authentifizierung und schreibt die Ergebnisse so zurück, dass eine Prüfung möglich ist. Android-Builds und Tests repräsentativer Bildschirme sind weiterhin vor der Abnahme erforderlich. Übersetzungen, die an anderer Stelle per Commit gespeichert wurden, gelangen über die Versionsverwaltung ins Projekt, während lingo pull die lokal erfasste Einreichung abruft.