Recursos de Android

Traduce las cadenas, los arreglos y los plurales compatibles sin alterar los nombres de los recursos de Android ni las reglas de los directorios de idioma.

Android usa los nombres de los recursos para vincular el texto visible con el código de la aplicación. El controlador de archivos android conserva esos nombres y traduce las cadenas, los elementos de arreglos de cadenas y los elementos de plurales compatibles dentro de un elemento raíz <resources>. Los atributos de cantidad y las posiciones en los arreglos siguen identificando los valores que carga Android.

Selección de recursos #

Un archivo de recursos puede combinar texto traducido con un nombre de producto fijo:

xml
<resources>
  <string name="checkout_title">Complete your order</string>
  <string name="brand" translatable="false">Acme</string>
  <string-array name="delivery_methods">
    <item>Standard delivery</item>
    <item>Express delivery</item>
  </string-array>
  <plurals name="items">
    <item quantity="one">%d item</item>
    <item quantity="other">%d items</item>
  </plurals>
</resources>

Los nombres de los recursos, las posiciones en los arreglos y las cantidades de los plurales identifican los valores traducibles. brand se omite porque tiene translatable="false". La identidad de cada elemento de un arreglo incluye su posición, por lo que cambiar el orden del arreglo cambia la correspondencia entre su texto y una traducción existente. La CLI actual no admite la selección de --key de Android; selecciona archivos de origen completos en su lugar.

El controlador lee los datos de caracteres de cada elemento y omite los que contienen elementos secundarios, como <b> o <xliff:g>. Proporciona por separado las traducciones revisadas de esos recursos con contenido enriquecido y verifica su cobertura cuando el archivo que los contiene esté completo. El texto que rodea un comentario XML en línea se une para traducirlo; al reemplazar el valor, ese comentario puede eliminarse. Su contenido no se usa como indicación para la traducción.

CDATA se interpreta como texto cuando forma un único valor de texto, y sus delimitadores se conservan durante la reconstrucción. El marcado dentro de CDATA forma parte del texto que se envía a traducir, no de una estructura de elementos secundarios protegida. Revisa esos recursos con el código que la aplicación usa realmente para renderizarlos.

Ubicación por idioma #

El origen habitual es res/values/strings.xml; la traducción al alemán debe ir en res/values-de/strings.xml. Los calificadores de región y sistema de escritura deben seguir la notación de Android, como values-pt-rBR o values-b+zh+Hans, en lugar de usar una cadena de idioma arbitraria después de values-.

La derivación de rutas de la CLI reconoce un directorio values sin modificadores cuando se especifica explícitamente el formato Android. No hace falta crear un enlace simbólico values-en artificial para esa estructura compatible. La notación de idioma de Android implícita en el formato y cualquier ruta de destino explícita deben definirse en la configuración de la CLI. Revisa la ruta derivada antes de aceptar la salida.

Reutilización y salida parcial #

El texto de origen anterior se compara según la identidad del recurso. La traducción existente aporta los valores coincidentes durante la reconstrucción. Usa lingo push --wait de la forma habitual para los cambios en el origen y conserva las traducciones aceptadas antes de forzar una actualización de todo el archivo. El texto fijo debe estar en recursos marcados con translatable="false"; los lockedKeys de la CLI no son controles de recursos de Android.

El controlador conserva las categorías de plural del origen. No garantiza que el conjunto esté completo ni que la redacción sea correcta para cada idioma de destino. Prueba las cantidades y las variables con formato usando el cargador de recursos de la aplicación.

Configura y verifica los recursos de Android #

Establece format: "android" explícitamente para los archivos de origen .xml de la CLI. XML por sí solo no permite identificar el vocabulario de recursos de Android. La GitHub App también acepta el tipo configurado.

Compila los recursos obtenidos con las herramientas de Android y luego abre una pantalla que use una cadena, un arreglo y un plural. Localiza una aplicación de Android completa ese flujo de trabajo. lingo check indica si cambió el origen o falta un archivo de destino, pero no si faltan recursos de Android dentro de un archivo.