So übersetzt du einen Xcode String Catalog mit KI

Ein Xcode String Catalog ist eine einzelne Datei, die alle Sprachen deiner App enthält. Um Deutsch, Japanisch und Portugiesisch hinzuzufügen, ergänzt du diese eine Datei. Den Rest übernimmt Xcode.

Diese Anleitung behandelt Localizable.xcstrings und das eine Merkmal, das sie von einem normalen Übersetzungsauftrag unterscheidet: die Pluralformen. Informationen zu anderen App-Formaten findest du unter App-Sprachdateien mit KI übersetzen.

Was ist ein String Catalog?

String Catalogs gibt es seit Xcode 15. In der WWDC23-Session von Apple werden sie als Möglichkeit beschrieben, alle Strings an einem Ort zu verwalten. Xcode findet nach jedem Build lokalisierbare Strings und fügt sie dem Catalog hinzu. Über die Plus-Schaltfläche kannst du eine Sprache hinzufügen.

Im Hintergrund steckt eine JSON-Datei, die standardmäßig Localizable.xcstrings heißt. Jeder Schlüssel enthält die Übersetzungen für alle Sprachen sowie den Kommentar für Übersetzer.

Welche Option solltest du wählen?

Lass die fünf Strings, die deine App verkaufen, von einem Menschen übersetzen. Die Tausenden dahinter kannst du durch eine Engine laufen lassen.

Warum AI Glot zu einem String Catalog passt

• Die Übersetzungen landen im richtigen Schlüssel und in der richtigen Sprache. Der Catalog bleibt eine einzige Datei.
• Pluralformen werden je Sprache erstellt. Im Russischen sind vier Formen nötig, im Arabischen sechs. Jede Form wird der passenden Kategorie zugeordnet.
• Formatspezifizierer bleiben erhalten. %@, %d und %1$@ bleiben im übersetzten String unverändert.
• Kommentare für Übersetzer bleiben ihren Schlüsseln zugeordnet.
• Du kannst nur die fehlenden Einträge ergänzen. Bereits geprüfte Strings bleiben unverändert.
• Erst der Plan, dann die Kosten.

Der Weg einer einzelnen Datei

Warum Pluralformen entscheidend sind

Im Englischen gibt es zwei Pluralformen. Andere Sprachen haben mehr, und eine Meldung wie „3 Fotos“ braucht in jeder Sprache die passende Form.

Eine Kategorie, die es in der Ausgangssprache nicht gibt, aber in der Zielsprache verwendet wird, wird ergänzt. Ein russischer Katalog erhält so beispielsweise die Formen few und many. Fehlt das, zeigt die App bei bestimmten Anzahlen die falsche Form an.

Was du anschließend prüfen solltest

Platzhalter und Gerätevarianten. Sie werden noch nicht übersetzt und bleiben unverändert. Im Plan siehst du, wie viele es davon gibt.

Sprachenliste. Öffne den Katalog in Xcode und prüfe, ob jede neue Sprache aufgeführt ist und der Fortschritt als abgeschlossen angezeigt wird.

Textlänge. Starte die App in einer neuen Sprache und öffne die Bildschirme mit den längsten Texten. Prüfe, ob Text über eine Schaltfläche hinausragt.

So geht’s Schritt für Schritt

1. Teste eine Datei kostenlos. Der String-Katalog-Übersetzer funktioniert ohne Konto und verarbeitet Dateien mit bis zu 2 MB und 5,000 Wörtern.

2. Lade Localizable.xcstrings hoch in der App. Du findest die Datei im Projektordner, im Ordner „Resources“, wenn du Apples Standardspeicherort übernommen hast.

3. Sag in einem Satz, was du brauchst.

Add German, Japanese and Portuguese.
Translate only the keys that have no translation in each language yet.

Der Satz bestimmt, was im gesamten Katalog übersetzt wird. Vorgaben zur Formulierung, zum Beispiel „jeden Formatbezeichner exakt wie im Original beibehalten“ oder „die informelle Anrede verwenden“, gehören bei der Freigabe in das zweite Feld, denn sie werden auf jeden String angewendet, während er geschrieben wird.

4. Füge ein Glossar hinzu mit dem App-Namen, den Feature-Namen und den Begriffen, die deine App immer auf dieselbe Weise verwendet. So erstellst du eines.

5. Lies den Plan und wähle eine Qualitätsstufe.

Lite liefert etwa dreimal so viele Wörter pro Credit und ist schneller. Das ist die richtige Wahl für eine neue Sprache, deren Übersetzung du anschließend prüfst. Standard eignet sich für die Strings auf deiner App-Store-Seite. Ein Credit entspricht bei Standard einem Wort.

6. Freigeben und herunterladen, dann den Katalog in deinem Projekt ersetzen.

Ein Katalog, mehrere Sprachen

Die Zahlen dienen nur als Beispiel. Anders als die meisten Formate enthält ein String Catalog alle Sprachen. Deshalb erhältst du eine Datei zurück, nicht eine pro Sprache.

Drei Möglichkeiten, es auszuführen

Über die Befehlszeile lässt sich der Vorgang bei jeder Veröffentlichung erneut ausführen, wenn Xcode neue Strings zum Katalog hinzugefügt hat:

id=$(aiglot batches create Localizable.xcstrings \
      --instruction "Add German, Japanese and Portuguese. Translate only the keys with no translation yet." \
      --json | jq -r '.data.id')
aiglot batches get "$id" --json | jq '.data.plan'
aiglot batches approve "$id" --quality lite \
  --instructions "Keep every format specifier exactly as written."
aiglot batches download "$id" --output Localizable.xcstrings

Mit deinem KI-Agenten: Binde AI Glot als MCP-Server ein. Der Agent kann dein Projekt lesen, Glossarbegriffe vorschlagen, den Auftrag ausführen und den Katalog wieder an seinen Platz legen.

In der App: hochladen, klicken, herunterladen. Gut für einen einmaligen Auftrag.

Eine API-Integration wird in der API-Dokumentation beschrieben.

Unter Preise siehst du, was ein größeres Volumen kostet. Ein kostenloses Konto enthält Guthaben, mit dem du eine echte Datei verarbeiten kannst.

Die hier genannten Beschränkungen galten zum Zeitpunkt der Erstellung dieses Textes: 8 MB pro String Catalog sowie 2 MB und 5,000 Wörter im kostenlosen Tool. Die Beschreibung von String Catalogs und „Export Localizations“ stammt aus Apples WWDC23-Session. Die Liste von DeepL stammt aus der eigenen Dokumentation. Dateinamen und String-Anzahlen in den Diagrammen sind Beispiele. In deinem Tarif werden die tatsächlichen Werte für deine Datei angezeigt. Diese kannst du kostenlos einsehen.