Eine Sprache hinzufügen, ohne alles neu zu übersetzen

Führe eine neue Zielsprache ein, behalte akzeptierte Übersetzungen bei und stelle sicher, dass die Anwendung die neuen Ressourcen nutzen kann.

Beim Hinzufügen einer Sprache greifen drei Aufgaben ineinander: die Sprache für die Übersetzung auswählen, die Ressourcen erstellen und dafür sorgen, dass die Anwendung sie lädt. Eine neue Sprachoption in der Oberfläche erstellt noch keinen Katalog. Ein übersetzter Katalog sorgt noch nicht dafür, dass die Route ihn verwendet.

Beginne mit einem wiederherstellbaren Stand der Quelle und der akzeptierten Zielübersetzungen. Halte die vorgesehene Sprache fest, bei Bedarf einschließlich Region oder Schriftsystem. pt-BR und pt-PT bezeichnen unterschiedliche Zielgruppen, deren Anforderungen an die Formulierungen voneinander abweichen können.

Bestehende Struktur und Vorgaben ansehen #

Liste Quellmuster, aktuelle Ziele und erwartete Ausgabepfade auf. Separate Zieldateien lassen sich unabhängig voneinander hinzufügen. Ein gemeinsam genutzter Xcode String Catalog speichert dagegen mehrere Spracheinträge in einer Datei. Ob alle Sprachen abgedeckt sind, lässt sich daher nicht allein daran erkennen, dass die Datei existiert.

Führe für die neue Zielgruppe eine Prüfung der Modellabdeckung, Terminologie, Sprachebene und Markenstimme durch. Übernimm Vorgaben für verwandte Sprachen nur dort, wo sie passen. Ein Begriff kann gleich bleiben, während sich die Anredekonventionen unterscheiden. Die Unterstützung von Rechts-nach-links-Sprachen erfordert außerdem Anpassungen an der Schreibrichtung und am Layout der Anwendung, nicht nur übersetzte Texte.

Die Zielsprache zum aktuellen CLI-Projekt hinzufügen #

Die aktuellen CLI-Zielsprachen stammen aus targetLocales in .lingo/config.json. push hat weder eine --target-locale- noch eine --locale-Option. Vergewissere dich in einem Monorepo, welche Projektkonfiguration das Arbeitsverzeichnis auswählt.

Schließe vor dem Hinzufügen der Zielsprache alle ausstehenden regulären Quellaktualisierungen für die bestehenden Sprachen mit lingo push --wait ab. Schließe die Prüfung ab, rufe die Ausgabe ab und gleiche diese Zielübersetzungen mit der aktuellen Quelle ab. Behalte diesen Quellstand beim Hinzufügen der neuen Sprache unverändert bei.

Beim nachträglichen Befüllen bleiben bestehende Zieldateien unverändert. Werden dabei nur die Dateien der neuen Sprache erstellt, bleibt die bestehende Quellbasis erhalten, damit ein späterer regulärer Push weiterhin ausstehende Änderungen für die anderen Sprachen verarbeiten kann. Wenn du diese Aktualisierungen zuerst abschließt, basieren die bestehenden und neuen Zielübersetzungen auf demselben Quellstand mit abgeschlossener Prüfung.

Füge die Zielsprache anschließend zur Konfiguration des installierten, authentifizierten und verknüpften Projekts hinzu und sieh dir die geplanten Arbeiten für fehlende Dateien an:

sh
lingo push --backfill-missing --estimate
lingo push --backfill-missing --wait

Die Schätzung übersetzt nichts und erstellt keinen Auftrag. Sie lädt jedoch Dateien hoch, die dem Server für die Planung fehlen. Sie funktioniert nicht offline und ist keine Preisgarantie. Das nachträgliche Befüllen durchläuft die konfigurierten Muster und ergänzt fehlende Zieldateien; neue Schlüssel innerhalb einer bestehenden Zieldatei werden dabei nicht ergänzt. Sobald die neue Sprache auf dem aktuellen Stand ist, werden spätere reguläre Quelländerungen mit lingo push --wait auf Grundlage der gespeicherten Basis verarbeitet.

Bei gemeinsam genutzten XCStrings-Katalogen erfolgt die Planung pro Sprache innerhalb einer Datei. Sieh dir die neuen Einträge mithilfe des iOS-Workflows an.

Wenn die Anfrage nur eine Sprache betreffen darf, schränke targetLocales in einem kontrollierten Branch oder in einer Auftragskonfiguration ein und stelle anschließend die vollständige Liste wieder her. Verwende die Force-Option nicht allein, um die neue Sprache zu erreichen: Sie übersetzt bestehende Ziele im ausgewählten Umfang neu und kann Formulierungen mit bereits abgeschlossener Prüfung ersetzen. Push dokumentiert diese Unterschiede; die Sprachreferenz für CLI v0 behandelt die Flags dieser älteren Generation.

Einem Assistenten dieselben Grenzen setzen #

Ein Agent kann die Struktur untersuchen, sprachbezogene Vorgaben vorschlagen und die Konfigurationsänderungen vorbereiten. Lege fest, ob er lokale Dateien, die Lokalisierungs-Engine-Einstellungen der Organisation oder beides ändern darf. Delegation erläutert die Unterschiede zwischen diesen Befugnissen.

Bitte ihn, die jeweils geltenden primären Modelle und Fallback-Modelle sowie die gemeinsamen und sprachspezifischen Vorgaben zu erläutern. Vergewissere dich vor dem Vergleich der Ausgabe, welcher Stand gespeichert ist. Sprachauflösung erklärt die Auswahl; eine Modellpräferenz ist kein Maßstab für Sprachqualität.

Das Ergebnis für die neue Zielgruppe validieren #

Gleiche die zurückgegebenen Pfade und die Änderungen mit dem vorgesehenen Umfang ab. Bereits akzeptierte Zielübersetzungen sollten unverändert bleiben, sofern nicht eine Quellaktualisierung oder eine autorisierte Korrektur die Änderung erklärt. Validiere Variablen, Pluralzweige und Sprachmetadaten mit den Ressourcenwerkzeugen der Anwendung.

Lade repräsentative Inhalte in der neuen Sprache. Kontrolliere neben der Bedeutung auch Fallback-Verhalten, Textüberläufe und Schreibrichtung. Bewahre den Quellstand und das Ergebnis für die Messung auf, bevor du die Abdeckung erweiterst.

Wenn du eine Sprache aus der Konfiguration entfernst, wird sie für neue Arbeiten nicht mehr ausgewählt. Ressourcen oder Laufzeitrouten werden dadurch nicht gelöscht. Entscheide über diese Änderungen separat, insbesondere wenn ein gemeinsam genutzter Katalog die Quelle und mehrere Sprachen enthält.