Localizar uma aplicação Android
Traduza os recursos Android, coloque-os nos diretórios dos idiomas correspondentes e verifique as mensagens na aplicação.
O Android seleciona o texto localizado nos diretórios de recursos, enquanto o código da aplicação continua a utilizar 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 ficheiro de recursos predefinido e apresentá-los num ecrã com outro idioma ativo.
Siga este procedimento para XML nativo do Android. Para Flutter, consulte Recursos ARB e código de localização gerado; para catálogos JSON, consulte Localização em React Native.
Preparar os recursos que o ecrã carrega #
Mantenha os recursos predefinidos 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>Ligue estes recursos ao ecrã através das chamadas a recursos já existentes na aplicação. welcome identifica a mensagem; %1$s aceita o nome fornecido pelo código. O recurso de plural precisa da contagem para selecionar a forma correta e formatar a mensagem. translatable="false" mantém o nome do produto fora do processo de tradução.
O processador de ficheiros Android seleciona os itens de texto simples e ignora os que misturam texto com elementos subordinados em linha. Se uma mensagem contiver elementos subordinados, como <b> ou <xliff:g>, trate essas entradas separadamente. O texto CDATA pode ser traduzido sem alterar os seus delimitadores; a marcação no seu interior é tratada como texto, não como uma estrutura de elementos subordinados protegida. Verifique os recursos com formatação avançada no renderizador que a aplicação utiliza efetivamente.
Configurar a seleção dos ficheiros de origem e os caminhos dos idiomas #
Na raiz do projeto, instale e associe 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 da organização e do motor de localização associados e defina explicitamente o formato do ficheiro:
{
"pattern": "app/src/main/res/values/strings.xml",
"format": "android"
}Utilize esse objeto como entrada do ficheiro. A extensão .xml, por si só, não permite distinguir o Android de outro vocabulário XML. Adicione entradas de origem para outros ficheiros 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 qualificadores e gera os qualificadores 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 |
Esta estrutura não precisa de uma ligação simbólica values-en. Se uma configuração anterior utilizava uma, atualize e verifique a configuração antes de a remover. Um diretório simples como values-pt-BR não utiliza o qualificador regional esperado. A Configuração da CLI explica os caminhos de destino explícitos e a forma de escrever os identificadores de idioma.
Traduzir e carregar o primeiro idioma de destino #
Para os ficheiros de destino em falta, execute:
lingo push --backfill-missing --waitAguarde que a execução termine, incluindo qualquer revisão configurada, e verifique o XML obtido. Compare os nomes dos recursos, a ordem dos elementos das listas, os atributos de quantidade, o nome fixo do produto e os especificadores de formato com os da origem. Sem --wait, obtenha o resultado da execução concluída com lingo pull no checkout a partir do qual foi submetida.
Compile com a configuração Gradle do projeto e execute a aplicação num dispositivo ou emulador configurado para um idioma de destino. Abra o ecrã e introduza um nome e várias contagens. Uma compilação bem-sucedida valida a sintaxe e as referências dos recursos; a verificação no dispositivo confirma que o Android selecionou efetivamente o diretório traduzido.
Leia os resultados para contagens que abranjam as categorias de plural do idioma de destino. O processador mantém a estrutura de plural da origem, pelo que as formas inglesas one e other não garantem todas as formas necessárias no idioma de destino. Verifique os rótulos longos, o texto de acessibilidade e a disposição da direita para a esquerda, quando necessário. lingo check não substitui a validação dos recursos Android nem a verificação de que estão completos.
Continuar com alterações à origem #
Registe num único commit a origem, as traduções de destino aceites, a configuração associada e .lingo/lock.json. Depois de editar os textos de origem, traduza as alterações com:
lingo push --waitPara voltar a gerar todas as traduções de um ficheiro de origem depois de alterar as orientações do motor, guarde as traduções de destino aceites e execute:
lingo push "app/src/main/res/values/strings.xml" --force --waitEsta operação substitui as traduções do ficheiro selecionado nos idiomas de destino configurados. Consulte Âmbitos da CLI para saber mais sobre a seleção de ficheiros e a regeneração.
Guarde uma comparação das traduções de destino antes e depois da operação. Marque os recursos Android fixos com translatable="false", como no exemplo do nome do produto acima. Guarde as correções existentes antes de atualizar as traduções. Para detetar alterações nas traduções de destino feitas após a submissão, omita --wait e verifique lingo pull --dry-run antes de obter os resultados. Preservar traduções revistas explica esta verificação e a gestão de conflitos.
Quando o primeiro ecrã estiver a funcionar, utilize a GitHub App ou um executor de CI para traduções recorrentes. O executor gere a autenticação e a gravação dos resultados para revisão; as compilações Android e as verificações de ecrãs representativos continuam a ser necessárias antes da aceitação. As traduções registadas em commits noutros locais chegam através do controlo de versões, enquanto lingo pull obtém os resultados da submissão registada localmente.