Localiza una app de Flutter
Traduce mensajes ARB, genera recursos de Flutter y revisa la pantalla resultante en cada idioma de destino.
Las herramientas de localización de Flutter convierten los mensajes ARB en los métodos que llaman tus widgets. Lingo.dev traduce esos recursos ARB para que puedas agregar idiomas sin cambiar la API generada. Comienza con una pantalla que incluya un saludo y un conteo de elementos para revisar el texto, las variables y el comportamiento de los plurales en conjunto.
Este procedimiento supone que el proyecto ya carga su ARB de origen mediante la generación de recursos de localización de Flutter. Conserva el l10n.yaml, el generador y las llamadas de los widgets existentes. En este proceso, Lingo.dev se encarga de traducir los archivos; Flutter sigue seleccionando el idioma y mostrando los mensajes.
Dale a cada mensaje la información que necesita #
Para un archivo de origen en lib/l10n/app_en.arb, usa un catálogo como este:
{
"@@locale": "en",
"welcome": "Welcome, {name}",
"@welcome": {
"description": "Greeting on the signed-in account screen",
"placeholders": { "name": { "type": "String" } }
},
"itemCount": "{count, plural, =0{No items} =1{One item} other{{count} items}}",
"@itemCount": {
"description": "Number of items in the cart",
"placeholders": { "count": { "type": "int" } }
}
}La descripción explica a quien traduce cómo se usa el mensaje. Las definiciones de los marcadores de posición le indican a Flutter qué valores proporciona el código que hace la llamada. El procesador de ARB traduce las dos cadenas de los mensajes, conserva los metadatos y actualiza el campo @@locale existente con el idioma de destino.
Primero ejecuta el generador de recursos de localización del proyecto sobre el archivo de origen y usa los métodos generados para el saludo y el conteo en la pantalla. Así confirmas que el catálogo original y el código que lo utiliza coinciden antes de agregar otro idioma.
Vincula el catálogo a un motor de localización #
Instala la versión actual de la CLI y autentícate desde la raíz del proyecto:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets de,fr --files 'lib/l10n/app_en.arb' --yes
lingo linkinit escribe .lingo/config.json; link selecciona la organización y el motor de localización. Conserva los identificadores generados. Los campos de localización deben seleccionar solo el archivo de origen:
{
"sourceLocale": "en",
"targetLocales": ["de", "fr"],
"files": [
{ "pattern": "lib/l10n/app_en.arb", "format": "flutter" }
]
}Esta es la sección de localización de la configuración vinculada; no reemplaza sus IDs de organización y motor de localización. La extensión .arb también selecciona flutter automáticamente. Esta estructura genera app_de.arb y app_fr.arb; confirma que el generador del proyecto los lea. Si usas otra estructura, define una ruta de destino explícita.
Evita un patrón de origen como app_*.arb que también seleccione catálogos traducidos. Para las variantes regionales de idioma, usa nombres de archivo que coincidan con la configuración del proyecto de Flutter, en lugar de suponer que cualquier cadena de idioma funciona sin cambios en un nombre de archivo.
Traduce y genera los recursos de destino #
Para generar los archivos de destino que faltan, ejecuta:
lingo push --backfill-missing --waitEl comando espera a que termine la ejecución y descarga los archivos. Si la ejecución queda pendiente de revisión o falla, resuelve ese estado antes de generar los recursos de la versión que vas a publicar. Un primer envío simple puede establecer la versión de referencia del origen sin solicitar las traducciones faltantes.
Revisa las claves de destino, las descripciones, los nombres y tipos de los marcadores de posición y @@locale. Luego ejecuta la generación de recursos de localización de Flutter, el análisis, las pruebas y la compilación del proyecto. Corrige cualquier expresión ICU no válida, marcador de posición faltante o tipo incompatible antes de continuar. La reconstrucción de ARB conserva los metadatos, pero no valida todos los mensajes traducidos con el generador de Flutter.
Abre la pantalla en alemán y francés. Introduce un nombre corto y uno largo; luego prueba conteos de 0, 1, 2 y un número mayor. Lee cómo están redactados los plurales en lugar de comprobar solo que aparezca un número. Algunos idiomas pueden requerir categorías adicionales a las del original en inglés, así que revisa las formas necesarias en el idioma de destino. Verifica la selección del idioma, el idioma de respaldo, la expansión del texto y su dirección cuando corresponda. El formato de fechas y números sigue dependiendo de Flutter en tiempo de ejecución.
Mantén las actualizaciones posteriores vinculadas al origen #
Mantén juntos la configuración, el origen, los archivos de destino aceptados y .lingo/lock.json. Después de cambiar un mensaje de origen, ejecuta lingo push --wait y revisa ese mensaje junto a otro cercano que no haya cambiado. Modificar solo la descripción no convierte por sí solo el texto del mensaje en una nueva tarea de traducción; usa una actualización delimitada cuando el contexto revisado deba dar lugar a una nueva traducción.
No edites los archivos de destino mientras esté pendiente la escritura de los resultados. Para proteger las correcciones locales de esos archivos, envía sin --wait, revisa lingo pull --dry-run y luego descarga con lingo pull en el checkout desde el que hiciste el envío. Las otras máquinas necesitan traducciones guardadas en un commit o una transferencia explícita de artefactos; no des por hecho que comparten la última ejecución. Consulta Conserva las traducciones revisadas para conocer los detalles de recuperación.
Una vez que este ciclo funcione, usa la GitHub App o la automatización de CI para repetir la traducción y la generación de recursos antes de la revisión. Los archivos nativos XML de Android y los recursos de Apple tienen requisitos distintos para los archivos y el tiempo de ejecución; mantenlos separados de la generación de ARB en un proyecto multiplataforma.