Localiza una aplicación de React Native
Traduce un catálogo de mensajes JSON existente con la CLI y carga los archivos de idioma generados en tu aplicación de React Native.
Las aplicaciones de React Native pueden usar react-i18next con archivos de traducción JSON. Lingo.dev traduce esos archivos mediante un motor de localización configurado, mientras que la biblioteca de mensajes que ya utilizas selecciona el idioma y muestra los mensajes.
Este flujo de trabajo parte de un catálogo existente organizado por claves. Conserva las claves de los mensajes, la sintaxis de interpolación, la convención para los plurales y la configuración en tiempo 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 archivo .lingo/config.json resultante tiene esta estructura. Conserva los identificadores reales de la organización y del motor que se hayan generado durante la vinculación:
{
"orgId": "org_...",
"engineId": "eng_...",
"sourceLocale": "en",
"targetLocales": ["es", "fr", "de", "ja"],
"files": [{ "pattern": "src/locales/en.json" }]
}La CLI reconoce 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 añadirse como nuevos archivos de origen. Añade una entrada por cada espacio de nombres de origen si la aplicación utiliza varios archivos.
Traduce y carga los mensajes #
Crea los archivos de destino que faltan:
lingo push --backfill-missing --waitCuando termine el proceso, comprueba el JSON generado. Incluye los catálogos de destino en las importaciones de recursos o en el cargador que ya utiliza la aplicación y regístralos con el idioma y el espacio de nombres que usa react-i18next. La configuración en tiempo de ejecución y el targetLocales de la CLI deben especificar 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 aplicación. Comprueba que se carga el catálogo de destino y que no se recurre al idioma de origen sin avisar.
Mantén sincronizados los cambios posteriores en el origen #
Guarda en el 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 comprobaciones en pantalla antes de publicar. Para automatizar el proceso, usa la GitHub App o el flujo de trabajo de CI. Los apartados controles de formato JSON y conservación de traducciones revisadas explican cómo se gestionan y recuperan los archivos.