Android-Ressourcen
Übersetzen Sie unterstützte Zeichenfolgen, Arrays und Pluralformen, ohne Android-Ressourcennamen oder die Regeln für Sprachverzeichnisse zu verändern.
Android verknüpft sichtbaren Text über Ressourcennamen mit dem Anwendungscode. Der Dateihandler android behält diese Namen bei und übersetzt unterstützte Zeichenfolgen, Einträge in Zeichenfolgen-Arrays und Pluraleinträge innerhalb eines <resources>-Wurzelelements. Mengenattribute und Array-Positionen bestimmen weiterhin, welche Werte Android lädt.
Ressourcenauswahl #
Eine Ressourcendatei kann übersetzten Text mit einem unveränderlichen Produktnamen kombinieren:
<resources>
<string name="checkout_title">Complete your order</string>
<string name="brand" translatable="false">Acme</string>
<string-array name="delivery_methods">
<item>Standard delivery</item>
<item>Express delivery</item>
</string-array>
<plurals name="items">
<item quantity="one">%d item</item>
<item quantity="other">%d items</item>
</plurals>
</resources>Ressourcennamen, Array-Positionen und Mengenangaben für Pluralformen identifizieren die übersetzbaren Werte. brand wird übersprungen, weil es das Attribut translatable="false" hat. Zur Identität von Array-Einträgen gehört auch ihre Position. Wenn Sie das Array neu anordnen, ändert sich daher die Zuordnung seiner Texte zu einer vorhandenen Zielübersetzung. Die aktuelle CLI unterstützt die Auswahl über Android---key nicht; wählen Sie stattdessen ganze Quelldateien aus.
Der Handler liest die Zeichendaten jedes Eintrags und überspringt Einträge mit untergeordneten Elementen wie <b> oder <xliff:g>. Stellen Sie für diese Ressourcen mit eingebettetem Markup separat Zielübersetzungen bereit, die eine Prüfung durchlaufen haben, und kontrollieren Sie deren Abdeckung, sobald die umgebende Datei vollständig ist. Text vor und nach einem eingebetteten XML-Kommentar wird für die Übersetzung zusammengefügt. Beim Ersetzen des Werts kann dieser Kommentar verloren gehen; sein Wortlaut dient nicht als Übersetzungshinweis.
CDATA wird als Text eingelesen, wenn es einen einzelnen Textwert bildet. Bei der Rekonstruktion bleibt die CDATA-Umrahmung erhalten. Markup innerhalb von CDATA gehört zum Text, der zur Übersetzung gesendet wird, und gilt nicht als geschützte untergeordnete Struktur. Kontrollieren Sie diese Ressourcen mit dem tatsächlichen Darstellungscode der Anwendung.
Ablage nach Sprache #
Die Quelle liegt üblicherweise in res/values/strings.xml; eine deutsche Zielübersetzung gehört in res/values-de/strings.xml. Qualifizierer für Region und Schriftsystem müssen der Android-Schreibweise entsprechen, etwa values-pt-rBR oder values-b+zh+Hans. Eine beliebige Sprachkennung hinter values- genügt nicht.
Die Pfadableitung der CLI erkennt ein reines values-Verzeichnis, wenn das Android-Format explizit angegeben ist. Ein eigens angelegter values-en-Symlink ist für diese unterstützte Verzeichnisstruktur nicht nötig. Die vom Format vorgegebene Android-Schreibweise der Sprache und ein gegebenenfalls explizit angegebener Zielpfad gehören in die CLI-Konfiguration. Kontrollieren Sie den abgeleiteten Pfad, bevor Sie die Ausgabe übernehmen.
Wiederverwendung und Teilausgabe #
Der bisherige Quelltext wird anhand der Ressourcenidentität verglichen. Bei der Rekonstruktion liefert die vorhandene Zielübersetzung die passenden Werte. Verwenden Sie bei Änderungen an der Quelle wie gewohnt lingo push --wait und sichern Sie akzeptierte Zielübersetzungen, bevor Sie eine Aktualisierung der gesamten Datei erzwingen. Unveränderlicher Text gehört in Ressourcen mit der Kennzeichnung translatable="false"; CLI-lockedKeys dienen nicht zur Steuerung von Android-Ressourcen.
Der Handler behält die Pluralkategorien der Quelle bei. Er garantiert weder einen vollständigen Satz an Kategorien noch korrekte Formulierungen für jede Zielsprache. Testen Sie Mengen und formatierte Variablen mit dem Ressourcenlader der Anwendung.
Android-Ressourcen konfigurieren und verifizieren #
Legen Sie format: "android" für .xml-Quellen in der CLI explizit fest. XML allein reicht nicht aus, um das Android-Ressourcenvokabular zu erkennen. Auch die GitHub App akzeptiert den konfigurierten Typ.
Erstellen Sie mit den abgerufenen Ressourcen und den Android-Werkzeugen einen Build. Öffnen Sie anschließend einen Bildschirm, der eine Zeichenfolge, ein Array und eine Pluralform verwendet. Eine Android-App lokalisieren rundet diesen Workflow ab. lingo check meldet eine geänderte Quelle oder eine fehlende Zieldatei, nicht jedoch fehlende Android-Ressourcen innerhalb einer Datei.