Apple-Strings
Werte in Apple-Zeichenfolgentabellen übersetzen, dabei Suchschlüssel beibehalten und den rekonstruierten Text mit Escape-Sequenzen versehen.
Eine Apple-Zeichenfolgentabelle ordnet festen Suchschlüsseln den angezeigten Text zu. Der Dateihandler für xcode-strings übersetzt die Werte auf der rechten Seite, behält die Schlüssel bei und schreibt die Zeichenfolgenliterale mit Escape-Sequenzen in eine .strings-Datei pro Sprache zurück.
Schlüssel und Werte #
Zum Beispiel:
/* Checkout heading */
"checkout.title" = "Complete your order";
"delivery.estimate" = "Delivery within %d days";Die beiden Werte auf der rechten Seite sind Texteinheiten. checkout.title und delivery.estimate bleiben als Suchschlüssel erhalten. Kommentare bleiben den Einträgen zugeordnet, werden von diesem Handler aber nicht als Übersetzungshinweise übernommen. Nutze bei mehrdeutigen kurzen Beschriftungen die Kontextmechanismen, die der Übersetzungs-Workflow unterstützt.
Schlüssel und Werte in Anführungszeichen, Zuweisungszeichen und Semikolons gehören zur unterstützten Syntax für Zeichenfolgentabellen. Der Parser dekodiert unterstützte Escape-Sequenzen. Bei der Ausgabe werden Anführungszeichen, Backslashes, Zeilenumbrüche, Tabulatoren und Wagenrückläufe mit Escape-Sequenzen versehen. Beim Ersetzen der Werte bleiben die umgebenden Kommentare und die Abstände zwischen den Einträgen erhalten.
Merge und Ablage der Ressourcen #
Anhand der vorherigen Quelldatei wird über die Schlüssel ermittelt, welche Werte sich geändert haben. Eine vorhandene Zieldatei liefert die Übersetzungen, die beibehalten werden. Die aktuelle Quelldatei legt fest, welche Einträge und Kommentare enthalten sind. Nutze für geänderte Texte reguläre Aktualisierungen der Quelldatei. Wenn du die Übersetzungsvorgaben geändert hast, kannst du stattdessen gezielt die gesamte Datei aktualisieren; siehe CLI-Geltungsbereiche.
Lege die Sprachressourcen dort ab, wo die Anwendung sie lädt, zum Beispiel unter en.lproj/Localizable.strings und de.lproj/Localizable.strings. Eine Quelldatei in Base.lproj wird bei der Pfadableitung anders behandelt als eine Datei in einem nach einer Sprache benannten Verzeichnis. Sieh dir das Ziel mit dem ausgewählten Werkzeug an. Die Übersetzung der Tabelle legt weder die Entwicklungssprache der Anwendung noch die Ressourcenzugehörigkeit fest.
Zeichenfolgentabelle konfigurieren und laden #
Die CLI leitet xcode-strings aus .strings ab. Die Auswahl- und Pfadregeln findest du unter CLI-Konfiguration, Informationen zur verwalteten Ausgabe ins Repository unter GitHub.
Lade die Zieltabelle in der App und teste die Formatbezeichner mit konkreten Werten. Nutze stringsdict für Ressourcen zur Auswahl von Pluralformen. Wenn das Projekt Zeichenfolgenkataloge verwendet, halte dich stattdessen an deren Merge-Regeln für gemeinsam genutzte Dateien: Das Umbenennen eines Katalogs pro Sprache würde eine andere Ressourcenstruktur erzeugen.