Localize um app Android
Traduza os recursos do Android, coloque-os nos diretórios corretos de cada idioma e confira as mensagens no app.
O Android seleciona os textos localizados nos diretórios de recursos, enquanto o código do aplicativo continua usando os mesmos nomes de recursos. O Lingo.dev traduz esses recursos para os diretórios de destino. Um bom primeiro passo é escolher uma saudação, uma lista e um recurso de plural do arquivo de recursos padrão e exibi-los em uma tela com o app configurado para outro idioma.
Use este procedimento para XML nativo do Android. Para Flutter, siga Recursos ARB e código de localização gerado; para catálogos JSON, siga Localização no React Native.
Prepare os recursos que a tela carrega #
Mantenha os recursos padrão em app/src/main/res/values/strings.xml:
<resources>
<string name="welcome">Welcome, %1$s!</string>
<string name="product_name" translatable="false">ExampleApp</string>
<string-array name="delivery_options">
<item>Standard delivery</item>
<item>Express delivery</item>
</string-array>
<plurals name="items_count">
<item quantity="one">%d item</item>
<item quantity="other">%d items</item>
</plurals>
</resources>Conecte esses recursos à tela pelas chamadas de recursos já existentes no aplicativo. welcome identifica a mensagem; %1$s recebe o nome fornecido pelo código. O recurso de plural precisa da contagem para selecionar a forma e formatar o texto. translatable="false" mantém o nome do produto fora do processo de tradução.
O processador de arquivos Android seleciona itens de texto simples e ignora aqueles que misturam texto e marcação de elementos filhos. Se uma mensagem contiver elementos filhos, como <b> ou <xliff:g>, trate essas entradas separadamente. O texto em CDATA pode ser traduzido sem alterar seus delimitadores; a marcação dentro dele é tratada como texto, não como uma estrutura protegida de elementos filhos. Confira os recursos com formatação avançada no renderizador usado pelo aplicativo.
Configure a seleção da origem e os caminhos dos idiomas #
Na raiz do projeto, instale e vincule a CLI:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,pt-BR,zh-Hans --files 'app/src/main/res/values/strings.xml' --yes
lingo linkEm .lingo/config.json, mantenha os IDs vinculados da organização e do engine de localização e defina explicitamente o formato do arquivo:
{
"pattern": "app/src/main/res/values/strings.xml",
"format": "android"
}Use esse objeto como entrada do arquivo. A extensão .xml, por si só, não distingue o Android de outro vocabulário XML. Adicione entradas de origem para outros arquivos de recursos, como arrays.xml, sem incluir os diretórios de destino gerados.
A versão atual da CLI reconhece o diretório values/ sem qualificador e gera os qualificadores do Android para os caminhos de destino:
| Idioma de destino | Diretório de destino |
|---|---|
es | values-es |
pt-BR | values-pt-rBR |
zh-Hans | values-b+zh+Hans |
Essa estrutura dispensa um link simbólico values-en. Se uma configuração antiga usava esse link, atualize e confira a configuração antes de removê-lo. Um diretório sem adaptação, como values-pt-BR, não usa o qualificador regional esperado. Configuração da CLI explica os caminhos de destino explícitos e a grafia dos identificadores de idioma.
Traduza e carregue o primeiro idioma de destino #
Para arquivos de destino ausentes, execute:
lingo push --backfill-missing --waitAguarde o fim da execução, incluindo qualquer revisão configurada, e confira o XML obtido. Compare os nomes dos recursos, a ordem dos itens nos arrays, os atributos de quantidade, o nome fixo do produto e os especificadores de formato com a origem. Sem --wait, obtenha os resultados da execução concluída com lingo pull no checkout de onde ela foi enviada.
Compile com a configuração Gradle do projeto e execute o app em um dispositivo ou emulador configurado para um idioma de destino. Abra a tela e informe um nome e diferentes contagens. Uma compilação bem-sucedida valida a sintaxe e as referências dos recursos; a verificação no dispositivo confirma que o Android realmente selecionou o diretório traduzido.
Confira o texto exibido para contagens que testem as categorias de plural do idioma de destino. O processador preserva a estrutura de plural da origem, portanto as formas one e other do inglês não garantem todas as formas necessárias no idioma de destino. Confira rótulos longos, textos de acessibilidade e o layout da direita para a esquerda, quando necessário. lingo check não substitui a validação dos recursos do Android nem a verificação de que todos os recursos necessários estão presentes.
Continue com as alterações na origem #
Faça um único commit com a origem, as traduções de destino aceitas, a configuração vinculada e .lingo/lock.json. Depois de editar os textos de origem, traduza as alterações com:
lingo push --waitPara gerar novamente todas as traduções de um arquivo de origem após alterar as orientações do engine, salve as traduções de destino aceitas e execute:
lingo push "app/src/main/res/values/strings.xml" --force --waitIsso substitui as traduções do arquivo selecionado nos idiomas de destino configurados. Consulte Escopos da CLI para saber como selecionar arquivos e gerar as traduções novamente.
Mantenha uma comparação das traduções de destino antes e depois da alteração. Marque os recursos fixos do Android com translatable="false", como no exemplo do nome do produto acima. Salve as correções existentes antes de atualizar as traduções. Para detectar edições nas traduções de destino feitas após o envio, omita --wait e confira lingo pull --dry-run antes de obter os resultados. Preserve as traduções revisadas explica essa verificação e o tratamento de conflitos.
Depois que uma tela estiver funcionando, use o GitHub App ou um executor de CI para traduções recorrentes. O executor cuida da autenticação e da gravação das alterações para revisão; a compilação do Android e a verificação de telas representativas continuam sendo necessárias antes da aceitação. As traduções salvas em commits em outro local chegam pelo controle de versão, enquanto lingo pull recupera os resultados do envio registrado localmente.