.XML - Android (Strings Android)

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Extensões de arquivo	.xml
Extensão de API	xml
Importar	Sim
Exportar	Sim
Suporte para formas plurais	Sim
Suporte para descrição	Sim
Opções de formato Estas opções que podem ser especificadas quando um arquivo é feito upload e/ou Download. Dependendo do método de upload/Download (API, CLI, sincronização de repositório, etc.), eles podem ser especificados em parâmetros de consulta `upload`, `Download` ou no arquivo de configuração `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 é uma variação de XML específica do Android que pode ser usada para carregar conteúdo traduzido em aplicativos Android. Seu elemento raiz é um <resources> com numerosos elementos <string> aninhados sob ele que armazenam Strings pendentes de tradução. Você pode usar o Android Studio para gerar esses arquivos de recurso e usar o Phrase para gerenciar a tradução.

O Android Studio usa a propriedade traduzível para indicar se o conteúdo precisa ser traduzido. No Phrase, essa propriedade é ignorada. Não há necessidade de enviar essas Strings para o Phrase. Se uma string não deve ser traduzida, defina-a em um arquivo de recurso separado com todas as strings não traduzíveis (por exemplo, donottranslate.xml).

Opções de formato

Identificador	convert_placeholder
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	O marcador de posição será convertido para corresponder aos requisitos específicos do formato. Exemplo: `$s' => '$@`

Identificador	escape_linebreaks
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Todas as quebras de linha serão escapadas como `\\n`

Identificador	unescape_linebreaks
Tipo	Booleano
Upload	Sim
Baixar	Não
Padrão	false
Descrição	Todos os `\\n` serão importados como novas linhas verdadeiras

Identificador	enclose_in_cdata
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Envolve traduções que contêm tags HTML em CDATA

Identificador	indent_size
Tipo	integer
Upload	Não
Download	Sim
Padrão	4
Descrição	Especifica o número de caracteres de recuo

Identificador	indent_style
Tipo	string
Upload	Não
Download	Sim
Padrão	espaço
Descrição	Especifica o caractere de recuo. Os valores permitidos são `espaço` e `aba`.

Identificador	unescape_tags
Tipo	Booleano
Upload	Sim
Baixar	Não
Padrão	false
Descrição	Todos os caracteres `<` serão desescapados para `<` e todos os caracteres `>` serão desescapados para `>` para tags.

Identificador	include_tools_locale_definition
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Incluir o atributo `tools:locale` no XML resultante.

Identificador	include_tools_ignore
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Inclua o `Ferramentas:ignorar` atributo no XML resultante. Quando desativado (padrão), o atributo `Ferramentas:ignorar` é omitido dos arquivos exportados. Isso ajuda a manter os arquivos de recursos limpos e evita a inclusão de atributos de supressão de lint específicos do desenvolvimento.

Identificador	preserve_cdata
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Se o conteúdo da tradução já contiver a código CDATA, esta opção evita que o conteúdo seja escapado adicionalmente.

Identificador	escape_android_chars
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Escapa `@`, `?` e `aba` caracteres especiais do Android com um prefixo de barra invertida.

Identificador	unescape_android_chars
Tipo	Booleano
Upload	Sim
Baixar	Não
Padrão	false
Descrição	Desescapa `\\@`, `\\?`, `\\t` e `\\uXXXX` (caractere Unicode com chave XXXX).

Amostra de código

<?xml version="1.0" encoding="UTF-8"?>
<resources>
    <string name="boolean_key">--- true
</string>
    <string name="empty_string_translation"/>
    <!-- Esta é a bela descrição para esta chave! -->
    <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\">Esta tradução contém
a line-break.</string>
    <string name=\"nested.deeply.key\">Ei, esta chave está aninhada ainda mais profundamente.</string>
    <string name=\"nested.key\">Esta chave está aninhada dentro de um namespace.</string>
    <string name="null_translation"/>
    <plurals name="pluralized_key">
        <item quantity=\"one\">Apenas uma forma plural encontrada.</item>
        <item quantity=\"other\">Ei, você tem %s pluralizações!</item>        
    </plurals>
    <string-array name="sample_collection">
        <item>primeiro item</item>
        <item>segundo item</item>
        <item>terceiro item</item>
    </string-array>
    <string name=\"simple_key\">Apenas uma chave com uma mensagem.</string>
    <string name=\"unverified_key\">Esta tradução ainda não está verificada e aguarda por isso.</string> (Em alguns formatos nós também exportar este estado)</string>
</resources>

Plurais para arquivos XML do Android

Para valores plurais atribuir um código <plurals> especial como este:

<plurals name="messages">
        <item quantity=\"one\">Uma mensagem recebida.</item>
        <item quantity="other">%s messages received.</item>        
</plurals>