XML - Cadenas deAndro Android (Strings)

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 cargar/Descargar (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 usar para cargar contenido traducido en aplicaciones Android. Su elemento raíz es un <resources> con numerosos elementos <string> anidados bajo él 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 usa la propiedad translatable para indicar si el contenido necesita ser traducido. En Phrase, esta propiedad se ignora. No hay necesidad de enviar estas cadenas a Phrase. Si una cadena no debe ser traducida, defínala en un archivo de recursos separado con todas las cadenas no traducibles (p. ej., 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 coincidir 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 saltos de línea reales

Identificador	enclose_in_cdata
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Encierra las 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 sangría

Identificador	indent_style
Tipo	cadena
Carga	No
Descarga	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
Carga	Sí
Descarga	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
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Incluir el `Herramientas:localización` atributo en el XML resultante.

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

Identificador	preserve_cdata
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Si el contenido de la traducción ya contiene una 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 `pestaña` 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">Check it out! This key has a description! (At least in some formats)</string>
    <string name="key_with_line-break">This translations contains
a line-break.</string>
    <string name="nested.deeply.clave">Oye, esta clave está anidada aún más profundamente.</string>
    <string name="nested.clave">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">¡Oye, 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_clave">Solo una clave con un mensaje.</string>
    <string name="unverified_clave">Esta traducción aún no está verificado y espera por ello. (En algunos formatos también exportar este estado)</string>
</recursos>

Plurales para archivos XML de Android

Para valores plurales asignar una <plurals> etiqueta especial como esta:

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