Eine React-Native-App lokalisieren
Übersetze einen bestehenden JSON-Nachrichtenkatalog mit der CLI und lade die generierten Sprachdateien in deine React-Native-App.
React-Native-Apps können react-i18next mit JSON-Übersetzungsdateien nutzen. Lingo.dev übersetzt diese Dateien über eine konfigurierte Lokalisierungs-Engine. Deine bestehende Nachrichtenbibliothek wählt weiterhin die Sprache aus und stellt die Nachrichten dar.
Dieser Workflow setzt einen bestehenden Katalog mit Nachrichtenschlüsseln voraus. Behalte die Nachrichtenschlüssel, die Interpolationssyntax, die Konvention für Pluralformen und die Laufzeitkonfiguration bei.
Quellkatalog konfigurieren #
Liegt deine Quelldatei unter src/locales/en.json, initialisiere die CLI im Stammverzeichnis des Projekts:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr,de,ja --files 'src/locales/en.json' --yes
lingo linkDie resultierende .lingo/config.json hat folgende Struktur. Behalte die tatsächlichen Organisations- und Engine-IDs bei, die beim Verknüpfen erzeugt wurden:
{
"orgId": "org_...",
"engineId": "eng_...",
"sourceLocale": "en",
"targetLocales": ["es", "fr", "de", "ja"],
"files": [{ "pattern": "src/locales/en.json" }]
}Die CLI erkennt JSON an der Dateiendung und leitet daraus Zielpfade wie src/locales/es.json ab. Wähle nur Quellkataloge aus; generierte Zielkataloge dürfen nicht als zusätzliche Quellen dienen. Wenn deine App mehrere Dateien nutzt, füge für jeden Quell-Namespace einen Eintrag hinzu.
Nachrichten übersetzen und laden #
Erstelle die fehlenden Zieldateien:
lingo push --backfill-missing --waitSieh dir nach Abschluss die generierten JSON-Dateien an. Binde die Zielkataloge in die bestehenden Ressourcenimporte oder den Loader deiner App ein und registriere sie unter der Sprache und dem Namespace, die react-i18next verwendet. Die Laufzeitkonfiguration und targetLocales der CLI müssen dieselben unterstützten Sprachen angeben.
Öffne auf einem Gerät oder Emulator einen Bildschirm in einer Zielsprache. Teste eine Beschriftung, einen interpolierten Wert und die Pluralformen deiner App. Stelle sicher, dass der Zielkatalog geladen wird und nicht unbemerkt die Quellsprache als Fallback angezeigt wird.
Spätere Änderungen an der Quelle synchron halten #
Erstelle einen gemeinsamen Commit für die Konfiguration, die Quelle, die akzeptierten Zielkataloge und .lingo/lock.json. Führe nach Änderungen an den Quellnachrichten Folgendes aus:
lingo push --waitFühre eine Prüfung der geänderten Kataloge durch und wiederhole vor der Veröffentlichung die Bildschirmtests. Nutze für die Automatisierung die GitHub App oder einen CI-Workflow. Unter JSON-Formateinstellungen und Übersetzungen nach der Prüfung beibehalten findest du Informationen zum Verhalten der Dateien und zum Abruf.