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:
<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.