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:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr,de,ja --files 'src/locales/en.json' --yes
lingo linkEl .lingo/config.json resultante tiene esta estructura. Conserva los ID reales de la organización y del motor que se generan al vincularlos:
{
"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:
lingo push --backfill-missing --waitAl 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:
lingo push --waitRevisa 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.