Lokalizujte aplikaci v React Native

Přeložte stávající katalog zpráv ve formátu JSON pomocí CLI a načtěte vygenerované jazykové soubory do své aplikace v React Native.

Aplikace v React Native mohou používat react-i18next s překladovými soubory ve formátu JSON. Lingo.dev tyto soubory přeloží pomocí nakonfigurovaného lokalizačního engine. Výběr jazyka a zobrazení zpráv přitom dál zajišťuje vaše stávající knihovna pro práci se zprávami.

Toto workflow vychází ze stávajícího katalogu zpráv s klíči. Zachovejte klíče zpráv, syntaxi interpolace, konvenci pro tvary množného čísla i nastavení běhového prostředí.

Nakonfigurujte zdrojový katalog #

Pokud je zdroj umístěný v src/locales/en.json, inicializujte CLI z kořenového adresáře projektu:

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr,de,ja --files 'src/locales/en.json' --yes
lingo link

Výsledný soubor .lingo/config.json má následující podobu. Ponechte v něm skutečná ID organizace a engine získaná při propojení:

json
{
  "orgId": "org_...",
  "engineId": "eng_...",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [{ "pattern": "src/locales/en.json" }]
}

CLI rozpozná formát JSON podle přípony a odvodí cílové cesty, například src/locales/es.json. Vybírejte pouze zdrojové katalogy; vygenerované cílové soubory nepřidávejte jako další zdroje. Pokud aplikace používá více souborů, přidejte položku pro každý zdrojový jmenný prostor.

Přeložte a načtěte zprávy #

Vytvořte chybějící cílové soubory:

sh
lingo push --backfill-missing --wait

Po dokončení zkontrolujte vygenerované soubory JSON. Přidejte cílové katalogy do stávajících importů prostředků nebo do načítacího mechanismu aplikace a zaregistrujte je pro jazyk a jmenný prostor, které používá react-i18next. Konfigurace běhového prostředí a targetLocales v CLI musí uvádět stejné podporované jazyky.

Na zařízení nebo v emulátoru otevřete obrazovku v cílovém jazyce. Otestujte popisek, interpolovanou hodnotu i tvary množného čísla v aplikaci. Ověřte, že se načítá cílový katalog a že aplikace místo něj bez upozornění nezobrazuje náhradní text ve zdrojovém jazyce.

Udržujte překlady v souladu s dalšími změnami zdroje #

Konfiguraci, zdroj, schválené cílové soubory a .lingo/lock.json uložte společně do jednoho commitu. Po úpravě zdrojových zpráv spusťte:

sh
lingo push --wait

Před vydáním zkontrolujte změněné katalogy a zopakujte kontroly obrazovek. K automatizaci použijte GitHub App nebo CI workflow. Podrobnosti o chování souborů a jejich načítání najdete v částech Nastavení formátu JSON a Zachování zkontrolovaných překladů.