Adicione um idioma sem retraduzir tudo

Adicione um novo idioma de destino, preserve as traduções aceitas e verifique se a aplicação consegue usar os novos recursos.

Adicionar um idioma envolve três tarefas: selecioná-lo para tradução, criar os recursos e fazer a aplicação carregá-los. Uma nova opção de idioma na interface não cria o catálogo correspondente. E um catálogo traduzido não faz a rota passar a usá-lo.

Comece com uma versão recuperável do conteúdo de origem e traduções de destino aceitas. Registre o idioma desejado, incluindo a região ou o sistema de escrita quando necessário. pt-BR e pt-PT identificam públicos diferentes, cujas necessidades de redação podem variar.

Confira a estrutura e as orientações existentes #

Liste os padrões dos arquivos de origem, os destinos atuais e os caminhos de saída esperados. Arquivos de destino separados podem ser adicionados de forma independente; já um catálogo de strings compartilhado do Xcode armazena vários idiomas em um único arquivo. Por isso, a existência do arquivo, por si só, não comprova a cobertura.

Analise a cobertura dos modelos, a terminologia, o registro linguístico e a voz para o novo público. Reutilize orientações de idiomas próximos apenas quando forem aplicáveis. Um termo pode ser o mesmo, ainda que as formas de tratamento sejam diferentes. O suporte a idiomas escritos da direita para a esquerda também exige ajustes na direção da escrita e no layout da aplicação, não apenas strings traduzidas.

Adicione o idioma de destino ao projeto atual da CLI #

Os idiomas de destino atuais da CLI vêm de targetLocales em .lingo/config.json. push não tem as opções --target-locale ou --locale. Em um monorepositório, confirme qual configuração de projeto o diretório de trabalho seleciona.

Antes de adicionar o idioma de destino, conclua com lingo push --wait as atualizações regulares do conteúdo de origem que estiverem pendentes para os idiomas existentes. Finalize a revisão, obtenha os arquivos gerados e confira essas traduções em relação ao conteúdo de origem atual. Mantenha essa versão do conteúdo de origem inalterada enquanto adiciona o novo idioma.

O preenchimento retroativo mantém os arquivos de destino existentes inalterados. Quando cria apenas os arquivos do novo idioma, preserva uma versão de referência existente do conteúdo de origem para que um envio regular posterior ainda possa processar as edições pendentes para os outros idiomas. Concluir essas atualizações primeiro mantém as traduções existentes e as novas alinhadas à mesma versão revisada do conteúdo de origem.

Em seguida, adicione o idioma de destino à configuração do projeto instalado, autenticado e vinculado e confira o trabalho previsto para os arquivos ausentes:

sh
lingo push --backfill-missing --estimate
lingo push --backfill-missing --wait

A estimativa não traduz nada nem cria uma tarefa, mas envia os arquivos que faltam no servidor para permitir o planejamento. Ela não funciona sem conexão e não garante o preço. O preenchimento retroativo percorre os padrões configurados e preenche os arquivos de destino ausentes; não preenche novas chaves em um arquivo de destino existente. Depois que o novo idioma estiver atualizado, as próximas alterações regulares no conteúdo de origem usarão lingo push --wait com base na versão de referência salva.

Em catálogos XCStrings compartilhados, o planejamento é feito por idioma dentro de um único arquivo; confira as novas entradas usando o workflow do iOS.

Se a solicitação precisar abranger apenas um idioma, restrinja targetLocales em uma branch controlada ou na configuração da tarefa e restaure a lista completa depois. Não adicione a opção de forçar só para incluir o novo idioma: ela retraduz os destinos existentes no escopo e pode substituir textos já revisados. Envio documenta essas diferenças; a referência de idiomas da CLI v0 aborda as opções dessa geração anterior.

Defina os mesmos limites para um assistente #

Um agente pode analisar a estrutura, propor orientações para o idioma e preparar o diff da configuração. Especifique se ele pode alterar arquivos locais, configurações do engine de localização que pertencem à organização ou ambos. Delegação explica a diferença entre essas autorizações.

Peça que ele explique quais modelos principais e alternativos se aplicam e quais orientações são compartilhadas ou específicas de cada idioma. Confirme o estado salvo antes de comparar os resultados. Resolução de idioma explica a seleção; uma preferência de modelo não é um parâmetro de qualidade linguística.

Verifique o resultado para o novo público #

Compare os caminhos retornados e o diff com o escopo pretendido. As traduções de destino já aceitas devem permanecer inalteradas, a menos que uma atualização do conteúdo de origem ou uma correção autorizada justifique a mudança. Valide as variáveis, as variantes de plural e os metadados de idioma com as ferramentas de recursos da aplicação.

Carregue conteúdo representativo no novo idioma. Além do significado, verifique o comportamento de fallback, se o texto ultrapassa os limites do layout e a direção da escrita. Guarde a versão do conteúdo de origem e o resultado para medição antes de ampliar a cobertura.

Remover um idioma da configuração impede que ele seja selecionado para novos trabalhos, mas não exclui recursos nem rotas em tempo de execução. Decida essas alterações separadamente, especialmente quando um catálogo compartilhado contém o conteúdo de origem e vários idiomas.