Localiza una app de Android

Traduce los recursos de Android, colócalos en los directorios de idioma correspondientes y verifica los mensajes en la app.

Android selecciona el texto localizado de los directorios de recursos, mientras que el código de la aplicación sigue usando los mismos nombres de recursos. Lingo.dev traduce esos recursos y los coloca en los directorios de destino. Para empezar, toma un saludo, una lista y un plural del archivo de recursos predeterminado y muéstralos en una pantalla que se ejecute en otro idioma.

Usa este procedimiento para XML nativo de Android. Para Flutter, sigue Recursos ARB y código de localización generado; para catálogos JSON, sigue Localización de React Native.

Prepara los recursos que carga la pantalla #

Mantén los recursos predeterminados en app/src/main/res/values/strings.xml:

xml
<resources>
  <string name="welcome">Welcome, %1$s!</string>
  <string name="product_name" translatable="false">ExampleApp</string>
  <string-array name="delivery_options">
    <item>Standard delivery</item>
    <item>Express delivery</item>
  </string-array>
  <plurals name="items_count">
    <item quantity="one">%d item</item>
    <item quantity="other">%d items</item>
  </plurals>
</resources>

Conecta estos recursos a la pantalla mediante las llamadas a recursos que ya usa la aplicación. welcome identifica el mensaje; %1$s acepta el nombre que proporciona el código. El recurso de plural necesita la cantidad para seleccionar la forma y aplicar el formato. translatable="false" deja el nombre del producto fuera del proceso de traducción.

El controlador de archivos de Android selecciona los elementos de texto sin formato y omite los que mezclan texto con marcado de elementos secundarios en línea. Si un mensaje contiene elementos secundarios como <b> o <xliff:g>, trata esas entradas por separado. El texto CDATA se puede traducir conservando su envoltura; el marcado que contiene se trata como texto, no como una estructura protegida de elementos secundarios. Verifica los recursos con formato enriquecido usando el renderizador de la aplicación.

Configura la selección de archivos de origen y las rutas de los idiomas #

Desde la raíz del proyecto, instala y vincula la CLI:

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,pt-BR,zh-Hans --files 'app/src/main/res/values/strings.xml' --yes
lingo link

En .lingo/config.json, conserva los ID de la organización y del motor de localización vinculados y luego define explícitamente el formato del archivo:

json
{
  "pattern": "app/src/main/res/values/strings.xml",
  "format": "android"
}

Usa ese objeto como entrada del archivo. La extensión .xml por sí sola no permite distinguir Android de otro vocabulario XML. Agrega entradas de origen para otros archivos de recursos, como arrays.xml, sin incluir los directorios de destino generados.

La CLI actual reconoce el directorio values/ sin calificadores y genera los calificadores de Android para las rutas de destino:

Idioma de destinoDirectorio de destino
esvalues-es
pt-BRvalues-pt-rBR
zh-Hansvalues-b+zh+Hans

Esta estructura no necesita un enlace simbólico values-en. Si una configuración anterior usaba uno, actualiza y revisa la configuración antes de eliminarlo. Un directorio sin adaptar, como values-pt-BR, no usa el calificador regional esperado. Configuración de la CLI explica las rutas de destino explícitas y cómo escribir los identificadores de idioma.

Traduce y carga el primer idioma de destino #

Para generar los archivos de destino que faltan, ejecuta:

sh
lingo push --backfill-missing --wait

Espera a que termine la ejecución, incluida cualquier revisión configurada, y revisa el XML recuperado. Compara con el origen los nombres de los recursos, el orden de los arreglos, los atributos de cantidad, el nombre fijo del producto y los especificadores de formato. Si no usas --wait, recupera la ejecución completada con lingo pull en el checkout desde el que se realizó el envío.

Compila con la configuración de Gradle del proyecto y luego ejecuta la app en un dispositivo o emulador configurado en un idioma de destino. Abre la pantalla e ingresa un nombre y varias cantidades. Una compilación exitosa verifica la sintaxis y las referencias de los recursos; la prueba en el dispositivo confirma que Android realmente seleccionó el directorio traducido.

Lee los resultados con cantidades que pongan a prueba las categorías de plural del idioma de destino. El controlador conserva la estructura de plurales del origen, por lo que las formas one y other del inglés no garantizan que estén todas las formas del idioma de destino. Verifica las etiquetas largas, el texto de accesibilidad y el diseño de derecha a izquierda cuando corresponda. lingo check no sustituye las verificaciones de recursos de Android ni las comprobaciones de que estén completos.

Continúa con los cambios en el origen #

Guarda en un mismo commit el origen, las traducciones aceptadas, la configuración vinculada y .lingo/lock.json. Después de editar las cadenas de origen, traduce los cambios con:

sh
lingo push --wait

Para regenerar todas las traducciones de un archivo de origen después de cambiar las instrucciones del motor, guarda las traducciones aceptadas y ejecuta:

sh
lingo push "app/src/main/res/values/strings.xml" --force --wait

Esto reemplaza las traducciones del archivo seleccionado en los idiomas de destino configurados. Consulta Ámbitos de la CLI para conocer las opciones de selección de archivos y regeneración.

Conserva una comparación de las traducciones de destino antes y después del cambio. Marca los recursos fijos de Android con translatable="false", como en el ejemplo anterior del nombre del producto. Guarda las correcciones existentes antes de regenerar las traducciones. Para detectar cambios en las traducciones de destino realizados después del envío, omite --wait y revisa lingo pull --dry-run antes de recuperarlas. Conservar las traducciones revisadas explica esta comprobación y cómo manejar los conflictos.

Una vez que una pantalla funcione, usa la GitHub App o un ejecutor de CI para las traducciones recurrentes. El ejecutor se encarga de la autenticación y de guardar los cambios para su revisión; aun así, antes de aceptar las traducciones, debes compilar para Android y verificar pantallas representativas. Las traducciones guardadas en commits en otro entorno llegan mediante el control de versiones, mientras que lingo pull recupera el envío registrado localmente.