Recursos do Android

Traduza strings, arrays e plurais compatíveis sem alterar os nomes dos recursos do Android nem as regras de diretórios por idioma.

O Android usa nomes de recursos para associar o texto visível ao código do aplicativo. O processador de arquivos android preserva esses nomes e traduz strings, itens de string-array e itens de plural compatíveis dentro de um elemento raiz <resources>. Os atributos de quantidade e as posições nos arrays continuam identificando os valores que o Android carrega.

Seleção de recursos #

Um arquivo de recursos pode combinar texto traduzido com um nome de produto fixo:

xml
<resources>
  <string name="checkout_title">Complete your order</string>
  <string name="brand" translatable="false">Acme</string>
  <string-array name="delivery_methods">
    <item>Standard delivery</item>
    <item>Express delivery</item>
  </string-array>
  <plurals name="items">
    <item quantity="one">%d item</item>
    <item quantity="other">%d items</item>
  </plurals>
</resources>

Os nomes dos recursos, as posições nos arrays e as quantidades de plural identificam os valores traduzíveis. brand é ignorado porque tem translatable="false". A identidade de cada item do array inclui sua posição. Por isso, reordenar o array altera a correspondência entre seu texto e uma tradução existente. A versão atual da CLI não oferece suporte à seleção de --key do Android; selecione arquivos de origem inteiros.

O processador lê os dados de caracteres de cada item e ignora os itens que contêm elementos filhos, como <b> ou <xliff:g>. Forneça separadamente as traduções revisadas desses recursos com formatação e confira sua cobertura quando o restante do arquivo estiver concluído. O texto ao redor de um comentário XML em linha é unido para tradução; substituir o valor pode remover esse comentário, cujo conteúdo não é usado como orientação para a tradução.

CDATA é interpretado como texto quando forma um único valor textual, e seus delimitadores são preservados na reconstrução. A marcação escrita dentro de CDATA faz parte do texto enviado para tradução, não de uma estrutura protegida de elementos filhos. Verifique esses recursos com o código que o aplicativo realmente usa para renderizá-los.

Organização dos arquivos por idioma #

O arquivo de origem geralmente fica em res/values/strings.xml; uma tradução para alemão deve ficar em res/values-de/strings.xml. Os qualificadores de região e sistema de escrita precisam seguir a notação do Android, como values-pt-rBR ou values-b+zh+Hans, em vez de usar uma string de idioma arbitrária após values-.

A derivação de caminhos da CLI reconhece um diretório values sem qualificadores quando o formato Android é definido explicitamente. Não é necessário criar um link simbólico artificial values-en para essa estrutura compatível. A notação de idioma do Android implícita no formato e qualquer caminho de destino explícito devem ser definidos na configuração da CLI. Confira o caminho derivado antes de aceitar a saída.

Reutilização e saída parcial #

O texto de origem anterior é comparado com base na identidade do recurso. A tradução existente fornece os valores correspondentes durante a reconstrução. Use lingo push --wait normalmente para alterações na origem e preserve as traduções aceitas antes de forçar uma atualização do arquivo inteiro. Textos fixos devem ficar em recursos marcados com translatable="false"; os lockedKeys da CLI não controlam os recursos do Android.

O processador preserva as categorias de plural da origem. Ele não garante um conjunto completo de categorias nem a redação correta para todos os idiomas de destino. Teste as quantidades e as variáveis formatadas com o carregador de recursos do aplicativo.

Configurar e verificar os recursos do Android #

Defina format: "android" explicitamente para origens .xml da CLI. O XML, por si só, não identifica o vocabulário de recursos do Android. O GitHub App também aceita o tipo configurado.

Compile os recursos obtidos com as ferramentas do Android e abra uma tela que use uma string, um array e um plural. Localizar um aplicativo Android completa esse workflow. lingo check sinaliza uma alteração na origem ou a ausência de um arquivo de destino, não a falta de recursos do Android dentro de um arquivo.