Localizar uma aplicação Flutter
Traduza mensagens ARB, gere recursos Flutter e verifique o ecrã resultante em cada idioma de destino.
As ferramentas de localização do Flutter transformam as mensagens ARB nos métodos que os seus widgets invocam. O Lingo.dev traduz esses recursos ARB, permitindo-lhe adicionar idiomas sem alterar a API gerada. Comece por um ecrã com uma saudação e uma contagem de itens, para verificar em conjunto o texto, as variáveis e o comportamento dos plurais.
Este procedimento pressupõe que o projeto já carrega o ARB de origem através da geração de recursos de localização do Flutter. Mantenha o l10n.yaml, o gerador e as chamadas dos widgets existentes. Neste processo, o Lingo.dev trata da tradução dos ficheiros; o Flutter continua a selecionar o idioma e a apresentar as mensagens.
Dê a cada mensagem as informações de que precisa #
Para um ficheiro de origem em lib/l10n/app_en.arb, utilize um catálogo como este:
{
"@@locale": "en",
"welcome": "Welcome, {name}",
"@welcome": {
"description": "Greeting on the signed-in account screen",
"placeholders": { "name": { "type": "String" } }
},
"itemCount": "{count, plural, =0{No items} =1{One item} other{{count} items}}",
"@itemCount": {
"description": "Number of items in the cart",
"placeholders": { "count": { "type": "int" } }
}
}A descrição explica ao tradutor como a mensagem é utilizada. As definições dos marcadores de posição indicam ao Flutter os valores fornecidos pelo código que invoca o método. O processador de ARB traduz as duas cadeias de texto das mensagens, preserva os metadados e altera o campo @@locale existente para o idioma de destino.
Execute primeiro o gerador de localização do projeto com o ficheiro de origem e utilize no ecrã os métodos gerados para a saudação e a contagem. Assim, confirma que o catálogo original e o código que o invoca são compatíveis antes de introduzir outro idioma.
Associe o catálogo a um motor de localização #
Instale a versão atual da CLI e autentique-se a partir da raiz do projeto:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets de,fr --files 'lib/l10n/app_en.arb' --yes
lingo linkinit escreve .lingo/config.json; link seleciona a organização e o motor de localização. Mantenha os identificadores gerados. Os campos de localização devem selecionar apenas o ficheiro de origem:
{
"sourceLocale": "en",
"targetLocales": ["de", "fr"],
"files": [
{ "pattern": "lib/l10n/app_en.arb", "format": "flutter" }
]
}Este excerto corresponde à parte de localização da configuração associada e não substitui os respetivos IDs da organização e do motor de localização. A extensão .arb também seleciona flutter automaticamente. Esta estrutura gera app_de.arb e app_fr.arb; confirme que o gerador do projeto os lê. Para uma estrutura diferente, defina um caminho de destino explícito.
Evite padrões de origem como app_*.arb que também selecionem catálogos traduzidos. Para idiomas com variantes regionais, faça corresponder a grafia dos nomes dos ficheiros à configuração do projeto Flutter, em vez de pressupor que qualquer identificador de idioma funciona sem alterações num nome de ficheiro.
Traduza e gere os recursos de destino #
Para os ficheiros de destino em falta, execute:
lingo push --backfill-missing --waitO comando aguarda a conclusão e obtém os ficheiros. Se a execução ficar a aguardar revisão ou falhar, resolva essa situação antes de gerar os recursos para lançamento. Um primeiro envio simples pode estabelecer a versão de referência da origem sem solicitar estas traduções em falta.
Verifique as chaves de destino, as descrições, os nomes e tipos dos marcadores de posição e @@locale. Em seguida, execute a geração de recursos de localização do Flutter, a análise, os testes e a compilação do projeto. Corrija quaisquer expressões ICU inválidas, marcadores de posição em falta ou tipos incompatíveis antes de prosseguir. A reconstrução do ARB preserva os metadados, mas não valida todas as mensagens traduzidas face aos requisitos do gerador do Flutter.
Abra o ecrã em alemão e francês. Introduza um nome curto e um nome comprido e, depois, contagens de 0, 1, 2 e um número maior. Leia as formas de plural em vez de verificar apenas se apareceu um número. Os idiomas podem exigir categorias que não existem no original em inglês, por isso reveja as formas necessárias no idioma de destino. Verifique a seleção do idioma, o idioma de recurso, a expansão do texto e a direção da escrita, quando aplicável. A formatação de datas e números continua a ser determinada pelo Flutter em tempo de execução.
Mantenha as atualizações seguintes ligadas à origem #
Mantenha a configuração, a origem, os ficheiros de destino aceites e .lingo/lock.json em conjunto. Depois de alterar uma mensagem de origem, execute lingo push --wait e verifique essa mensagem lado a lado com uma mensagem adjacente que não tenha sido alterada. Alterar apenas a descrição não cria, por si só, uma nova tarefa de tradução para o texto da mensagem; utilize uma atualização delimitada quando o contexto revisto deva desencadear uma nova tradução.
Não edite os ficheiros de destino enquanto a gravação das alterações estiver pendente. Para proteger as correções locais nos ficheiros de destino, submeta sem --wait, verifique lingo pull --dry-run e, em seguida, obtenha os ficheiros com lingo pull no checkout a partir do qual fez a submissão. As outras máquinas precisam de traduções guardadas num commit ou de uma transferência explícita de artefactos; não pressuponha que partilham a última execução. Consulte Preservar traduções revistas para obter detalhes sobre a recuperação.
Quando este ciclo estiver a funcionar, utilize a GitHub App ou a automatização de CI para repetir a tradução e a geração de recursos antes da revisão. O XML nativo do Android e os recursos nativos da Apple têm requisitos diferentes ao nível dos ficheiros e do tempo de execução; mantenha-os separados da geração de ARB num projeto multiplataforma.