Localiza una aplicación Android

Traduce los recursos de Android, colócalos en los directorios del idioma correspondiente y comprueba los mensajes en la aplicación.

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 con 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>

Vincula estos recursos a la pantalla mediante las llamadas a recursos que ya utiliza la aplicación. welcome identifica el mensaje; %1$s acepta el nombre proporcionado por 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 gestor 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 puede traducirse conservando su delimitación; el marcado que contiene se trata como texto, no como una estructura protegida de elementos secundarios. Comprueba los recursos con formato enriquecido con el renderizador que utiliza 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, a continuación, 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. Añade entradas de origen para otros archivos de recursos, como arrays.xml, sin incluir los directorios de destino generados.

La versión actual de la CLI 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 utiliza el calificador regional esperado. Configuración de la CLI explica cómo definir rutas de destino explícitas y escribir los identificadores de idioma.

Traduce y carga el primer idioma de destino #

Para los archivos de destino que falten, 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 elementos de las listas, los atributos de cantidad, el nombre fijo del producto y los especificadores de formato. Sin --wait, recupera la ejecución completada con lingo pull en el checkout desde el que se envió.

Compila con la configuración de Gradle del proyecto y, a continuación, ejecuta la aplicación en un dispositivo o emulador configurado en un idioma de destino. Abre la pantalla e introduce un nombre y varias cantidades. Una compilación correcta verifica la sintaxis y las referencias de los recursos; la comprobación en el dispositivo confirma que Android ha seleccionado realmente el directorio traducido.

Comprueba el texto que se muestra con cantidades que cubran las categorías de plural del idioma de destino. El gestor conserva la estructura de plurales del origen, por lo que las formas inglesas one y other no garantizan que estén presentes todas las formas del idioma de destino. Comprueba las etiquetas largas, el texto de accesibilidad y la disposición de derecha a izquierda cuando sea necesario. lingo check no sustituye las comprobaciones de los recursos de Android ni las que verifican que no falta nada.

Continúa con los cambios en el origen #

Incluye en el mismo commit el origen, las traducciones de destino aceptadas, la configuración vinculada y .lingo/lock.json. Tras 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 directrices del motor, guarda las traducciones de destino aceptadas y ejecuta:

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

Esto sustituye las traducciones del archivo seleccionado en los idiomas de destino configurados. Consulta Ámbitos de la CLI para obtener información sobre la selección de archivos y la 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 la gestión de conflictos.

Cuando 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 resultados de forma que puedan revisarse; las compilaciones de Android y las comprobaciones de pantallas representativas deben seguir realizándose antes de aceptar las traducciones. Las traducciones incluidas en commits en otros entornos llegan a través del control de versiones, mientras que lingo pull recupera el envío registrado localmente.