Apple-Stringkataloge

Aktualisiere die Werte der Zielsprache in einem XCStrings-Katalog und behalte dabei die Ausgangssprache und andere Sprachen bei.

Ein .xcstrings-Katalog bündelt den Ausgangstext und seine Übersetzungen. Der xcode-xcstrings-Dateihandler ergänzt die Einträge der Zielsprache direkt im Katalog und behält die anderen Sprachen in derselben Datei bei. Das Ergebnis ist ein aktualisierter Katalog am Quellpfad – keine neue Datei pro Sprache.

Quellwerte und Varianten #

Ein Eintrag mit einem ausdrücklich angegebenen englischen Quellwert sieht so aus:

json
{
  "sourceLanguage": "en",
  "strings": {
    "checkout.title": {
      "localizations": {
        "en": {
          "stringUnit": {
            "state": "translated",
            "value": "Complete your order"
          }
        }
      }
    }
  },
  "version": "1.0"
}

Der Text stammt aus dem ausgangssprachlichen stringUnit.value. Unterstützte Plural- oder Gerätevarianten liefern separate Blattwerte mit jeweils variantenspezifischer Identität. Fehlt einem Eintrag die Lokalisierung in der Ausgangssprache, dient sein Schlüssel als Ausgangstext. Dieser Rückgriff ist sinnvoll, wenn der Schlüssel den Ausgangstext enthält. Ein technischer Schlüssel wie checkout.title ersetzt jedoch nicht die beabsichtigte englische Nachricht.

Ein Eintrag mit shouldTranslate: false wird übersprungen. Katalogkommentare können in der gemeinsamen Struktur erhalten bleiben. Die Hinweise des Handlers geben jedoch das Format und die Variante an; daraus lässt sich nicht ableiten, dass jeder Kommentar als Übersetzungshinweis dient.

Vollständigkeit pro Sprache #

Die Vollständigkeitskontrolle erfolgt innerhalb der angeforderten Sprache. Der Handler wählt unterstützte Quellpositionen aus, die sich geändert haben oder für die ein Zielwert fehlt. So erhält auch eine neue Sprache Übersetzungen, obwohl der gemeinsame Katalog bereits vorhanden ist.

Im Katalog vorhandene Übersetzungen lassen sich auch mit CLI --force wiederverwenden. Wenn du eine separate Zieleingabe leerst, bleiben die Werte im Quellkatalog erhalten. Nutze das unten beschriebene Korrekturverfahren, wenn eine unveränderte Nachricht anders formuliert werden soll.

Die Zusammenstellung geht vom aktuellen Quellkatalog aus, übernimmt gegebenenfalls vorhandene Sprachdaten für dessen Einträge und schreibt die angeforderten Übersetzungen in die aktuellen Einträge und Varianten. Führe eine Prüfung des gesamten Diffs der gemeinsamen Datei durch – einschließlich der Änderungen am Ausgangstext und der unveränderten Sprachen. Neue Zieleinheiten erhalten den Status translated; die Freigabe durch einen Menschen bleibt eine separate Entscheidung im Rahmen der Prüfung.

Die Struktur der Plural- und Gerätevarianten richtet sich nach den unterstützten Quellblättern. Gehe nicht davon aus, dass sämtliche grammatischen Formen jeder Zielsprache generiert oder verifiziert wurden. Sieh dir die vorhandenen Varianten an und lass repräsentative Fälle in der App anzeigen.

Ausgabe in die gemeinsame Datei konfigurieren #

Die CLI leitet xcode-xcstrings aus .xcstrings ab und schreibt die Ausgabe an den Quellpfad. Für diesen Typ lässt die Konfiguration kein separates targetPath zu. Folge dem CLI-Schnellstart für Dateien bis zum Abruf oder nutze GitHub für die verwaltete Übersetzung von Repositorys.

Eine vorhandene Übersetzung korrigieren #

Für eine gezielte Formulierungskorrektur bearbeite den Wert der betreffenden Sprache in Xcode und verifiziere ihn in der App. Wenn du nach einer Änderung der Engine-Vorgaben eine Übersetzung neu generieren möchtest, schließe zunächst alle ausstehenden Übersetzungsarbeiten ab und sichere den gesamten Katalog. Behalte die vorhandene Baseline der CLI bei und nimm die gewünschte Sprache in targetLocales auf.

Entferne nur den Zieleintrag, den du neu generieren lassen möchtest. Im obigen Beispiel mit Deutsch als Zielsprache ist das strings["checkout.title"].localizations.de. Behalte en, die anderen Sprachen und benachbarte Einträge bei. Speichere die Datei und führe anschließend einen normalen inkrementellen Push aus:

sh
lingo push --wait

Der geänderte Katalog wird ohne diesen Zieleintrag übermittelt. Dadurch benötigt der ausgewählte Eintrag eine Übersetzung. Bearbeite die Datei während der Wartezeit nicht. Sieh dir den neuen deutschen Wert und den Diff des gesamten Katalogs an, bevor du das Ergebnis annimmst. Bei einem Eintrag mit Plural- oder Gerätevarianten werden durch das Entfernen seines Spracheintrags alle unterstützten Quellvarianten neu generiert.

Nutze dieses Verfahren mit der gespeicherten Baseline und einem einfachen Push. Muster als Positionsargumente, --backfill-missing und --key wählen andere Aufgaben aus; purge überspringt die gemeinsame Datei.

Prüfung der gesamten Katalogänderung #

Sichere den per Commit gespeicherten Katalog oder eine lokale Kopie, bevor du ihn ersetzt oder bereinigst. CLI purge überspringt dieses Format, weil Quelle und Ausgabe denselben Pfad verwenden. Wenn du eine einzelne Übersetzung neu generieren möchtest, entferne den betreffenden Spracheintrag wie oben beschrieben.

Die Katalogkontrollen der CLI belegen nicht, dass die Sprachen in XCStrings vollständig sind. Nutze Xcode und Kontrollen in der App, um Ressourcenzugehörigkeit, Entwicklungssprache, mehrere Kataloge, Platzhalter und angezeigte Varianten zu kontrollieren. Diesen Workflow findest du unter Eine iOS-App lokalisieren. Bei den älteren Formaten strings und stringsdict bleibt es bei separaten Dateien pro Sprache.