Recurso de textos do Android

Formato de arquivo específico do Android para traduzir aplicativos.

Dica

A very similar formats are Criar recursos multiplataforma and Recursos Kotlin para dispositivos móveis.

Os recursos de texto do Android são monolíngues, o Arquivo de idioma da base monolíngue é armazenado em um local diferente dos outros arquivos – res/values/strings.xml.

O Weblate faz o seguinte escape de textos:

• Se um texto for um XML válido, ela será inserida como XML para tradução.

• ? e @ são escapados com \\ no início do texto para evitar interpretá-los como referências de estilo ou recurso.

• Caso o texto contenha vários espaços, ele será colocado entre aspas duplas (").

• Novas linhas são escapadas como \\n, mas a nova linha real também é mantida para facilitar a leitura.

Nota

As estruturas de string-array do Android não são atualmente suportadas. Para contornar isso, você pode quebrar seus vetores de textos:

<string-array name="several_strings">
    <item>First string</item>
    <item>Second string</item>
</string-array>

se torna:

<string-array name="several_strings">
    <item>@string/several_strings_0</item>
    <item>@string/several_strings_1</item>
</string-array>
<string name="several_strings_0">First string</string>
<string name="several_strings_1">Second string</string>

O string-array que aponta para os elementos string deve ser armazenado em um arquivo diferente e não ser disponibilizado para tradução.

Este script pode ajudar a preprocessar seus arquivos strings.xml e traduções existentes: https://gist.github.com/paour/11291062

Dica

Para evitar a tradução de alguns textos, eles podem ser marcados como não traduzíveis. Isso pode ser especialmente útil para referências de textos:

<string name="foobar" translatable="false">@string/foo</string>

Ver também

• Android string resources documentation

• Criar recursos multiplataforma

• Recursos Kotlin para dispositivos móveis

• Android string resources

Recursos suportados

File extensions	.xml
Linguality ⓘ	Monolingual
Supports plural ⓘ	Yes
Supports descriptions ⓘ	Yes
Supports explanation ⓘ	No
Supports context ⓘ	No
Supports location ⓘ	No
Supports flags ⓘ	Yes
API identifier	aresource
Supports read-only strings ⓘ	Yes
Check flags added by this format ⓘ	Formato Java

Configuração do Weblate

Configuração de componente típica do Weblate
Máscara do arquivo	res/values-*/strings.xml
Arquivo de idioma da base monolíngue	res/values/strings.xml
Modelo para novas traduções	Vazio
Formato de arquivo	Recurso de textos de Android