Localiser une application React Native

Traduisez un catalogue de messages JSON existant avec la CLI, puis chargez les fichiers de langue générés dans votre application React Native.

Les applications React Native peuvent utiliser react-i18next avec des fichiers de traduction JSON. Lingo.dev traduit ces fichiers à l'aide d'un moteur de localisation configuré, tandis que votre bibliothèque de messages existante sélectionne la langue et affiche les messages.

Ce workflow s'appuie sur un catalogue existant structuré par clés. Conservez les clés des messages, la syntaxe d'interpolation, la convention de gestion des pluriels et la configuration d'exécution.

Configurer le catalogue source #

Pour une source située à src/locales/en.json, initialisez la CLI depuis la racine du projet :

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

Le fichier .lingo/config.json obtenu présente la structure suivante. Conservez les identifiants réels de l'organisation et du moteur générés lors de l'association :

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

La CLI reconnaît le format JSON grâce à l'extension et en déduit les chemins cibles, par exemple src/locales/es.json. Sélectionnez uniquement les catalogues sources : les fichiers cibles générés ne doivent pas servir de sources supplémentaires. Si l'application utilise plusieurs fichiers, ajoutez une entrée pour chaque espace de noms source.

Traduire et charger les messages #

Créez les fichiers cibles manquants :

sh
lingo push --backfill-missing --wait

Une fois l'opération terminée, vérifiez le JSON généré. Intégrez les catalogues cibles aux imports de ressources ou au chargeur déjà utilisés par l'application, puis enregistrez-les sous la langue et l'espace de noms utilisés par react-i18next. La configuration d'exécution et le targetLocales de la CLI doivent définir les mêmes langues prises en charge.

Ouvrez un écran dans une langue cible sur un appareil ou un émulateur. Testez un libellé, une valeur interpolée et les formes de pluriel de l'application. Vérifiez que l'application charge bien le catalogue cible, plutôt que d'afficher sans le signaler les messages de la langue source comme solution de repli.

Maintenir la synchronisation après chaque modification de la source #

Committez ensemble la configuration, la source, les fichiers cibles acceptés et .lingo/lock.json. Après avoir modifié les messages sources, exécutez :

sh
lingo push --wait

Relisez les catalogues modifiés et refaites les vérifications à l'écran avant la mise en production. Pour automatiser ces étapes, utilisez la GitHub App ou un workflow CI. Les pages Contrôles du format JSON et Conserver les traductions relues expliquent le comportement des fichiers et la récupération des traductions.