.XML - Android (Cadenas)

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

Extensiones de archivo	.xml
Extensión API	xml
Importar	Sí
Exportar	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 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

XML de Android es una variación de XML específica de Android que se puede usar 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. Puede 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
Cargar	No
Descargar	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
Cargar	No
Descargar	Sí
Por defecto	false
Descripción	Todos los saltos de línea se escaparán como `\n`

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

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

Identificador	indent_size
Tipo	integer
Cargar	No
Descargar	Sí
Por defecto	4
Descripción	Especifica el número de caracteres de sangría

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

Identificador	unescape_tags
Tipo	Booleano
Cargar	Sí
Descargar	No
Por defecto	false
Descripción	Todos los `<` caracteres se desescaparán a `<` y todos los `>` caracteres se desescaparán a `>` para las etiquetas.

Identificador	include_tools_locale_definition
Tipo	Booleano
Cargar	No
Descargar	Sí
Por defecto	false
Descripción	Incluye `Herramientas:localización` atributo en el XML resultante.

Identificador	include_tools_ignore
Tipo	Booleano
Cargar	No
Descargar	Sí
Por defecto	false
Descripción	Incluye el `Herramientas:ignorar` atributo en el XML resultante. Cuando está deshabilitado (por defecto), el atributo `Herramientas:ignorar` 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
Cargar	No
Descargar	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
Cargar	No
Descargar	Sí
Por defecto	false
Descripción	Escapa `@`, `?` y `pestaña` caracteres especiales de Android con un prefijo de barra invertida.

Identificador	unescape_android_chars
Tipo	Booleano
Cargar	Sí
Descargar	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"?>
<recursos>
    <string name="boolean_key">--- true
</string>
    <string name="empty_string_translation"/>
    <!-- ¡Esta es la hermosa descripción para esta clave! -->
    <cadena name="clave_con_descripción">¡Échale un vistazo! ¡Esta clave tiene una descripción! (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 profundo.</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 está a la espera de ello. (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>