.XML - Android (Cadenas)

El contenido se traduce automáticamente del inglés por Phrase Language AI.

Extensiones de archivo	.xml
Extensión API	xml
Importación	Sí
Exportación	Sí
Compatibilidad con formularios plurales	Sí
Compatibilidad con descripción	Sí
Opciones de formato Estas opciones que se pueden especificar cuando se carga y/o descarga un archivo. Dependiendo del método de carga/descarga (API, CLI, sincronización de repositorio, etc.), se pueden especificar en los parámetros de consulta `Cargar`, `Descargar` o en el archivo de configuración `phrase.yml`.	convert_placeholder escape_linebreaks unescape_linebreaks enclose_in_cdata indent_size indent_style unescape_tags include_tools_ignore include_tools_locale_definition escape_android_chars unescape_android_chars

Android XML es una variación de XML específica de Android que se puede utilizar para cargar contenido traducido en aplicaciones de Android. Su elemento raíz es un <resources> con numerosos elementos <string> anidados que almacenan cadenas pendientes de traducción. Puedes usar Android Studio para generar estos archivos de recursos y usar Phrase para gestionar la traducción.

Android Studio utiliza la propiedad traducible para indicar si el contenido necesita ser traducido. En Phrase, esta propiedad se ignora. No es necesario enviar estas cadenas a Phrase. Si una cadena no debe ser traducida, defínela en un archivo de recursos separado con todas las cadenas no traducibles (por ejemplo, donottranslate.xml).

Opciones de formato

Identificador	convert_placeholder
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	El marcador de posición se convertirá para cumplir con los requisitos específicos del formato. Ejemplo: `$s' => '$@`

Identificador	escape_linebreaks
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Todos los saltos de línea se escaparán como `\n`

Identificador	unescape_linebreaks
Tipo	Booleano
Carga	Sí
Descarga	No
Por defecto	false
Descripción	Todos los `\n` se importarán como verdaderos saltos de línea

Identificador	enclose_in_cdata
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Encierra traducciones que contienen etiquetas HTML en CDATA

Identificador	indent_size
Tipo	integer
Carga	No
Descarga	Sí
Por defecto	4
Descripción	Especifica el número de caracteres de indentación

Identificador	indent_style
Tipo	cadena
Carga	No
Descarga	Sí
Por defecto	espacio
Descripción	Especifica el carácter de indentación. Los valores permitidos son `espacio` y `pestaña`.

Identificador	unescape_tags
Tipo	Booleano
Carga	Sí
Descarga	No
Por defecto	false
Descripción	Todos los `<` caracteres serán desescapados a `<` y todos los `>` caracteres serán desescapados a `>` para las etiquetas.

Identificador	include_tools_locale_definition
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Incluir `tools:locale` atributo en el XML resultante.

Identificador	include_tools_ignore
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Incluir el `tools:ignore` atributo en el XML resultante. Cuando está deshabilitado (por defecto), el atributo `tools:ignore` se omite de los archivos exportados. Esto ayuda a mantener los archivos de recursos limpios y evita incluir atributos de supresión de lint específicos de desarrollo.

Identificador	preserve_cdata
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Si el contenido de la traducción ya contiene la etiqueta CDATA, este interruptor evita que el contenido se escape adicionalmente.

Identificador	escape_android_chars
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Escapa `@`, `?` y `Tab` caracteres especiales de Android con un prefijo de barra invertida.

Identificador	unescape_android_chars
Tipo	Booleano
Carga	Sí
Descarga	No
Por defecto	false
Descripción	Desescapa `\@`, `\?`, `\t` y `\uXXXX` (carácter Unicode con código XXXX).

Ejemplo de código

<?xml version="1.0" encoding="UTF-8"?>
<resources>
    <string name="boolean_key">--- true
</string>
    <string name="empty_string_translation"/>
    <!-- ¡Esta es la hermosa descripción para esta clave! -->
    <string name="key_with_description">¡Échale un vistazo! This key has a description! (Al menos en algunos formatos)</string>
    <string name="key_with_line-break">Esta traducción contiene
un salto de línea.</string>
    <string name="nested.deeply.key">Hola, esta clave está anidada aún más profundamente.</string>
    <string name="nested.key">Esta clave está anidada dentro de un espacio de nombres.</string>
    <string name="null_translation"/>
    <plurals name="pluralized_key">
        <item quantity="one">Solo se encontró una forma plural.</item>
        <item quantity="other">¡Hola, tienes %s pluralizaciones!</item>        
    </plurals>
    <string-array name="sample_collection">
        <item>primer elemento</item>
        <item>segundo elemento</item>
        <item>tercer elemento</item>
    </string-array>
    <string name="simple_key">Solo una clave con un mensaje.</string>
    <string name="unverified_key">Esta traducción aún no está verificada y espera por ello.</string> (En algunos formatos también exportamos este estado)</string>
</resources>

Plurales para archivos XML de Android

Para valores plurales, asigna una etiqueta especial <plurals> así:

<plurals name="messages">
        <item quantity="one">Un mensaje recibido.</item>
        <item quantity="other">%s mensajes recibidos.</item>        
</plurals>