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 |
convert_placeholder escape_linebreaks unescape_linebreaks enclose_in_cdata indent_size indent_style unescape_tags include_tools_locale_definition |
Android XML es una variación XML específica de Android que se puede utilizar para cargar contenido traducido en aplicaciones Android. Su elemento raíz es un <resources>
con numerosos elementos <cadena>
anidados bajo él que almacenan Strings pendientes de traducción. Puedes usar Android Studio para generar estos archivos de recursos y usar phrase para administrar la traducción.
Android Studio utiliza la propiedad traducible
para indicar si es necesario traducir el contenido. En phrase, esta propiedad se ignora. No es necesario push estas Strings a phrase. Si una cadena no debe traducirse, defínela en un archivo de recursos separado con todas Strings no traducibles (p. ej., donottranslate.xml
).
Opciones de formato
Identificador |
convert_placeholder |
Tipo |
Booleano |
Carga |
No |
Descarga |
Sí |
Por defecto |
false |
Descripción |
Los marcadores de posición se convertirán para que coincidan con los requisitos específicos del formato. Ejemplo: |
Identificador |
escape_linebreaks |
Tipo |
Booleano |
Carga |
No |
Descarga |
Sí |
Por defecto |
false |
Descripción |
Todos los saltos de línea se escaparán como |
Identificador |
unescape_linebreaks |
Tipo |
Booleano |
Carga |
Sí |
Descarga |
No |
Por defecto |
false |
Descripción |
Todos |
Identificador |
enclose_in_cdata |
Tipo |
Booleano |
Carga |
No |
Descarga |
Sí |
Por defecto |
false |
Descripción |
Incluye traducciones que contienen tags HTML en CDATA |
Identificador |
indent_size |
Tipo |
número entero |
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 carácter de sangría. Los valores permitidos son |
Identificador |
unescape_tags |
Tipo |
Booleano |
Carga |
Sí |
Descarga |
No |
Por defecto |
false |
Descripción |
Todos |
Identificador |
include_tools_locale_definition |
Tipo |
Booleano |
Carga |
No |
Descarga |
Sí |
Por defecto |
false |
Descripción |
Incluye |
Identificador |
preserve_cdata |
Tipo |
Booleano |
Carga |
No |
Descarga |
Sí |
Por defecto |
false |
Descripción |
Si el contenido ya contiene etiquetas CDATA, este interruptor evita que el contenido se escape adicionalmente. |
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 de esta clave! --> <cadena name="key_with_description">¡Échale un vistazo! This key has a description! (Al menos en algunos formatos)</cadena> cadena name="key_with_line-break">Estas traducciones contienen un salto de línea.</cadena> <cadena name="nested.deeply.key">Oye, esta clave está anidada aún más profundo.</cadena> <cadena name="nested.key">Esta clave está anidada dentro de un espacio de nombres.</cadena> <string name="null_translation"/> <plurals name="pluralized_key"> <item cantidad="uno">Solo se encontró un plural.</item> <item quantity="other">¡Oye, tienes %s pluralizaciones!</item> </plurals> <string-array name="sample_collection"> <item>primer artículo</item> <item>segundo artículo</item> <item>tercer artículo</item> </string-array> <cadena name="simple_clave">Solo una clave con un mensaje.</cadena> <cadena name="clave_sin verificar">Esta traducción aún no está verificada y la espera. (En algunos formatos también exportar este estado)cadena </resources>
Plurales para archivos XML de Android
Para valores plurales asignar una etiqueta especial <plurals> como esta:
<plurals name="messages"> <item cantidad="uno">Un mensaje recibido.</item> <item cantidad="other">%s mensajes recibidos.</item> </plurals>