Recursos de Android
Traduce las cadenas, las matrices y los plurales compatibles sin alterar los nombres de los recursos de Android ni las reglas de los directorios de idioma.
Android utiliza los nombres de los recursos para vincular el texto visible con el código de la aplicación. El procesador de archivos android conserva esos nombres y traduce las cadenas, los elementos de string-array y los elementos de plural compatibles dentro de un elemento raíz <resources>. Los atributos de cantidad y las posiciones en las matrices 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:
<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 las matrices y las cantidades de los plurales identifican los valores traducibles. brand se omite porque tiene translatable="false". La identidad de cada elemento de una matriz incluye su posición, por lo que reordenarla cambia la correspondencia entre su texto y una traducción existente. La CLI actual no admite la selección mediante --key en Android; selecciona archivos de origen completos en su lugar.
El procesador lee el contenido de texto de cada elemento y omite los que contienen elementos secundarios, como <b> o <xliff:g>. Proporciona por separado traducciones revisadas para esos recursos con formato enriquecido y comprueba su cobertura cuando el resto del archivo esté completo. El texto situado a ambos lados de un comentario XML intercalado se une para traducirlo; al sustituir el valor, ese comentario puede eliminarse. Su contenido no se utiliza como indicación para la traducción.
CDATA se analiza como texto cuando constituye un único valor de texto, y sus delimitadores se conservan durante la reconstrucción. El marcado escrito dentro de CDATA forma parte del texto que se envía a traducir, no de una estructura protegida de elementos secundarios. Revisa esos recursos con el código que utiliza la aplicación para mostrarlos.
Ubicación por idioma #
El origen habitual es res/values/strings.xml; la traducción al alemán debe estar 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 pegada después de values-.
La CLI reconoce un directorio values sin calificadores al calcular las rutas si se indica explícitamente el formato Android. No hace falta crear un enlace simbólico values-en para esa estructura compatible. La notación de idioma de Android implícita en el formato y cualquier ruta de destino explícita deben indicarse en la configuración de la CLI. Revisa la ruta calculada antes de aceptar el resultado.
Reutilización y resultados parciales #
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 procesador conserva las categorías de plural del origen. No garantiza que el conjunto de categorías esté completo ni que la redacción sea correcta para todos los idiomas de destino. Prueba las cantidades y las variables con formato con el cargador de recursos de la aplicación.
Configura y verifica los recursos de Android #
Establece format: "android" explícitamente para los orígenes .xml de la CLI. El 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, después, abre una pantalla que utilice una cadena, una matriz y un plural. Localizar una aplicación de Android completa ese flujo de trabajo. lingo check informa de cambios en el origen o de la ausencia de un archivo de destino, no de la falta de recursos de Android dentro de un archivo.