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:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr,de,ja --files 'src/locales/en.json' --yes
lingo linkVý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í:
{
"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:
lingo push --backfill-missing --waitPo 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:
lingo push --waitPř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ů.