Recursos Android

Traduza cadeias de texto, arrays e plurais suportados, preservando os nomes dos recursos Android e as regras dos diretórios de idioma.

O Android utiliza os nomes dos recursos para ligar o texto visível ao código da aplicação. O processador de ficheiros android preserva esses nomes e traduz as cadeias de texto, os itens de arrays de cadeias de texto e os itens de plural suportados dentro de um elemento raiz <resources>. Os atributos de quantidade e as posições nos arrays continuam a identificar os valores que o Android carrega.

Seleção de recursos #

Um ficheiro 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 dos plurais identificam os valores traduzíveis. brand é ignorado porque tem translatable="false". As posições fazem parte da identidade dos arrays, pelo que alterar a ordem de um array muda a forma como o seu texto é associado a uma tradução de destino existente. A CLI atual não suporta a seleção de --key do Android; selecione antes ficheiros de origem completos.

O processador lê os dados de caracteres de cada item e ignora os itens que contêm elementos-filho, como <b> ou <xliff:g>. Forneça separadamente traduções de destino revistas para esses recursos com formatação e verifique a respetiva cobertura quando o ficheiro que os contém estiver concluído. O texto em redor de um comentário XML intercalado é unido para tradução; a substituição do valor pode remover esse comentário, cujo conteúdo não é utilizado como indicação para a tradução.

O conteúdo CDATA é interpretado como texto quando constitui um único valor de texto, e os seus delimitadores são preservados na reconstrução. A marcação escrita dentro de CDATA faz parte do texto enviado para tradução e não é tratada como uma estrutura de elementos-filho protegida. Verifique esses recursos com o código de apresentação efetivamente utilizado pela aplicação.

Localização dos ficheiros de idioma #

O ficheiro de origem habitual é res/values/strings.xml; uma tradução de destino em alemão deve ficar em res/values-de/strings.xml. Os qualificadores de região e de sistema de escrita têm de seguir a notação do Android, como values-pt-rBR ou values-b+zh+Hans, em vez de usar uma cadeia de idioma arbitrária colada após values-.

A derivação de caminhos da CLI reconhece um diretório values sem qualificadores quando o formato Android é definido explicitamente. Esta estrutura suportada dispensa a criação de uma ligação simbólica artificial values-en. A notação de idioma Android implícita no formato e qualquer caminho de destino explícito devem ser definidos na configuração da CLI. Verifique o caminho derivado antes de aceitar o resultado.

Reutilização e resultado parcial #

O texto de origem anterior é comparado com base na identidade do recurso. O destino existente fornece os valores correspondentes durante a reconstrução. Utilize o lingo push --wait normal para alterações na origem e preserve as traduções de destino aceites antes de forçar uma atualização do ficheiro completo. O texto fixo deve ficar em recursos marcados com translatable="false"; os lockedKeys da CLI não são controlos de recursos Android.

O processador preserva as categorias de plural da origem. 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 da aplicação.

Configurar e verificar recursos Android #

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

Compile os recursos obtidos com as ferramentas Android e, em seguida, abra um ecrã que utilize uma cadeia de texto, um array e um plural. Localizar uma aplicação Android completa esse workflow. lingo check indica que a origem foi alterada ou que falta um ficheiro de destino, não que faltam recursos Android dentro de um ficheiro.