Localiza una app de React Native

Traduce un catálogo de mensajes JSON existente con la CLI y carga los archivos de idioma generados en tu app de React Native.

Las apps de React Native pueden usar react-i18next con archivos de traducción JSON. Lingo.dev traduce esos archivos a través de un motor de localización configurado, mientras que la biblioteca de mensajes que ya usas selecciona el idioma y muestra los mensajes.

Este flujo de trabajo parte de un catálogo existente con claves. Conserva las claves de los mensajes, la sintaxis de interpolación, la convención para los plurales y la configuración de ejecución.

Configura el catálogo de origen #

Si el archivo de origen está en src/locales/en.json, inicializa la CLI desde la raíz del proyecto:

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

El .lingo/config.json resultante tiene esta estructura. Conserva los ID reales de la organización y del motor que se generan al vincularlos:

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

La CLI identifica el formato JSON por la extensión y determina rutas de destino como src/locales/es.json. Selecciona solo los catálogos de origen; los archivos de destino generados no deben usarse como fuentes adicionales. Si la app usa varios archivos, agrega una entrada para cada espacio de nombres de origen.

Traduce y carga los mensajes #

Crea los archivos de destino que faltan:

sh
lingo push --backfill-missing --wait

Al terminar, revisa el JSON generado. Incluye los catálogos de destino en las importaciones de recursos que ya usa la app o en su cargador, y regístralos con el idioma y el espacio de nombres que usa react-i18next. La configuración de ejecución y el targetLocales de la CLI deben definir los mismos idiomas compatibles.

Abre una pantalla en un idioma de destino en un dispositivo o emulador. Prueba una etiqueta, un valor interpolado y las formas plurales de la app. Confirma que se cargue el catálogo de destino y que no se muestren, sin aviso, los mensajes del idioma de origen como alternativa.

Mantén sincronizados los cambios posteriores en el origen #

Guarda en un mismo commit la configuración, el origen, los archivos de destino aceptados y .lingo/lock.json. Después de editar los mensajes de origen, ejecuta:

sh
lingo push --wait

Revisa los catálogos modificados y repite las pruebas en pantalla antes del lanzamiento. Para automatizar el proceso, usa la GitHub App o el flujo de trabajo de CI. Los controles del formato JSON y la conservación de traducciones revisadas explican el comportamiento de los archivos y cómo recuperarlos.