Localize um app Flutter
Traduza mensagens ARB, gere recursos do Flutter e confira o resultado na tela em cada idioma de destino.
As ferramentas de localização do Flutter transformam mensagens ARB nos métodos que seus widgets chamam. O Lingo.dev traduz esses recursos ARB para você adicionar idiomas sem mudar a API gerada. Comece com uma tela que tenha uma saudação e uma contagem de itens: assim, você pode conferir o texto, as variáveis e o comportamento do plural em conjunto.
Este procedimento pressupõe que o projeto já carrega o ARB de origem por meio da geração de localização do Flutter. Mantenha o l10n.yaml, o gerador e as chamadas dos widgets existentes. Aqui, o Lingo.dev cuida da tradução dos arquivos; o Flutter continua responsável por selecionar o idioma e renderizar as mensagens.
Dê a cada mensagem as informações de que ela precisa #
Para um arquivo de origem em lib/l10n/app_en.arb, use 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 é usada. As definições dos parâmetros de substituição informam ao Flutter quais valores o código que faz a chamada fornece. O processador de ARB traduz as duas strings de mensagem, preserva os metadados e atualiza o campo @@locale existente com o idioma de destino.
Primeiro, execute o gerador de localização do projeto com o arquivo de origem e use na tela os métodos gerados para saudação e contagem. Isso confirma que o catálogo original e o código que faz as chamadas estão alinhados antes de adicionar outro idioma.
Vincule o catálogo a um engine de localização #
Na raiz do projeto, instale a versão atual da CLI e faça a autenticação:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets de,fr --files 'lib/l10n/app_en.arb' --yes
lingo linkinit grava .lingo/config.json; link seleciona a organização e o engine de localização. Mantenha os identificadores gerados. Os campos de localização devem selecionar apenas o arquivo de origem:
{
"sourceLocale": "en",
"targetLocales": ["de", "fr"],
"files": [
{ "pattern": "lib/l10n/app_en.arb", "format": "flutter" }
]
}Este trecho corresponde à parte de localização da configuração vinculada e não substitui os IDs da organização e do engine de localização. A extensão .arb também seleciona flutter automaticamente. Essa estrutura gera app_de.arb e app_fr.arb; confirme que o gerador do projeto lê esses arquivos. Para usar outra estrutura, defina um caminho de destino explícito.
Evite um padrão de origem como app_*.arb, que também seleciona catálogos traduzidos. Para variantes regionais de idioma, siga a grafia dos nomes de arquivo definida na configuração do projeto Flutter, em vez de presumir que qualquer identificador de idioma pode ser usado sem alterações em um nome de arquivo.
Traduza e gere os recursos de destino #
Para os arquivos de destino que ainda não existem, execute:
lingo push --backfill-missing --waitO comando aguarda a conclusão e baixa os arquivos. Se a execução ficar aguardando revisão ou falhar, resolva a situação antes de gerar os recursos de lançamento. Um primeiro envio simples pode estabelecer a versão de referência da origem sem solicitar as traduções ausentes.
Confira as chaves de destino, as descrições, os nomes e tipos dos parâmetros de substituição e @@locale. Em seguida, execute a geração de localização do Flutter, a análise, os testes e a compilação do projeto. Corrija qualquer expressão ICU inválida, parâmetro de substituição ausente ou tipo incompatível antes de continuar. A reconstrução do ARB preserva os metadados, mas não valida todas as mensagens traduzidas em relação aos requisitos do gerador do Flutter.
Abra a tela em alemão e francês. Informe um nome curto e um nome longo e, depois, contagens de 0, 1, 2 e um número maior. Leia o texto das formas de plural, em vez de conferir apenas se um número apareceu. Os idiomas podem exigir categorias além das existentes no inglês de origem, então revise as formas necessárias no idioma de destino. Verifique a seleção de idioma, o idioma alternativo, a expansão do texto e a direção da escrita, quando relevante. A formatação de datas e números continua a cargo do Flutter em tempo de execução.
Mantenha as próximas atualizações vinculadas à origem #
Mantenha a configuração, a origem, os arquivos de destino aceitos e .lingo/lock.json juntos. Após alterar uma mensagem de origem, execute lingo push --wait e confira essa mensagem ao lado de outra próxima que não tenha sido alterada. Alterar apenas a descrição não transforma, por si só, o texto da mensagem em uma nova tarefa de tradução; use uma atualização com escopo delimitado quando o contexto revisado precisar motivar uma nova tradução.
Não edite os arquivos de destino enquanto a gravação de retorno estiver pendente. Para proteger as correções locais nesses arquivos, envie sem --wait, confira lingo pull --dry-run e, em seguida, baixe com lingo pull no checkout usado para o envio. Outras máquinas precisam das traduções registradas em commit ou de uma transferência explícita dos artefatos; não presuma que a última execução seja compartilhada. Consulte Preserve as traduções revisadas para saber mais sobre a recuperação.
Quando esse ciclo estiver funcionando, use o GitHub App ou a automação de CI para repetir a tradução e a geração de recursos antes da revisão. Os formatos nativos XML do Android e recursos da Apple têm requisitos diferentes para os arquivos e o funcionamento em tempo de execução; mantenha-os separados da geração de ARB em um projeto multiplataforma.