.XML - Android (Strings)

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 Essas opções podem ser especificadas quando um arquivo é enviado e/ou baixado. Dependendo do método de upload/download (API, CLI, sincronização de repositório etc.), elas podem ser especificadas 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

O XML Android é 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 recursos e usar a Phrase para gerenciar a tradução.

O Android Studio usa a propriedade translatable para indicar se o conteúdo precisa ser traduzido. Na Phrase, essa propriedade é ignorada. Não há necessidade de enviar essas strings para a 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 de 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 contendo 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 indentação

Identificador	indent_style
Tipo	string
Upload	Não
Download	Sim
Padrão	espaço
Descrição	Especifica o caractere de indentação. 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	Inclua `Ferramentas:local` atributo 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 incluir atributos de supressão de lint específicos de desenvolvimento.

Identificador	preserve_cdata
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Se o conteúdo da tradução já contém a tag CDATA, esta opção impede 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 `Tab` 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 código 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">Confira! This key has a description! (Pelo menos em alguns formatos)</string>
    <string name="key_with_line-break">Esta tradução contém
uma quebra de linha.</string>
    <string name="nested.deeply.key">Ei, esta chave está aninhada ainda mais fundo.</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, também exportamos este estado)</string>
</resources>

Plurais para arquivos XML do Android

Para valores plurais, atribua uma tag especial <plurals> assim:

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