Adicionar um idioma sem voltar a traduzir tudo

Introduza um novo idioma de destino, preserve as traduções aceites e confirme que a aplicação consegue utilizar os novos recursos.

Adicionar um idioma envolve três tarefas interligadas: selecioná-lo para tradução, criar os recursos e garantir que a aplicação os carrega. Adicionar uma opção de idioma à interface não cria o respetivo catálogo. Ter um catálogo traduzido não faz com que a rota o utilize.

Comece com uma versão da origem que possa recuperar e traduções de destino aceites. Registe o idioma pretendido, incluindo a região ou o sistema de escrita, quando necessário. pt-BR e pt-PT designam públicos distintos, com requisitos de redação que podem variar.

Inspecionar a estrutura e as orientações existentes #

Liste os padrões dos ficheiros de origem, os idiomas de destino atuais e os caminhos de saída esperados. Os ficheiros de destino separados podem ser adicionados de forma independente; um catálogo de cadeias de caracteres do Xcode partilhado guarda entradas para vários idiomas num único ficheiro, pelo que a existência do ficheiro, por si só, não permite determinar a cobertura.

Reveja a cobertura dos modelos, a terminologia, o registo e a voz para o novo público. Reutilize orientações de idiomas próximos apenas quando forem aplicáveis. Um termo pode ser comum a vários idiomas, mas as formas de tratamento podem diferir. O suporte de idiomas escritos da direita para a esquerda também exige ajustes na direção de apresentação e na disposição dos elementos da aplicação, não apenas a tradução de cadeias de caracteres.

Adicionar o idioma de destino ao projeto CLI atual #

Os idiomas de destino atuais da CLI são definidos por targetLocales em .lingo/config.json. push não tem a opção --target-locale nem a opção --locale. Num monorepositório, confirme qual a configuração de projeto selecionada pelo diretório de trabalho.

Antes de adicionar o idioma de destino, conclua com lingo push --wait as atualizações normais da origem que estejam pendentes para os idiomas existentes. Termine a revisão, obtenha o resultado e compare essas traduções de destino com a origem atual. Mantenha essa versão da origem inalterada enquanto adiciona o novo idioma.

O preenchimento retroativo mantém os ficheiros de destino existentes inalterados. Quando cria apenas os ficheiros do novo idioma, preserva a versão de referência da origem já existente, para que um envio normal posterior possa continuar a processar as alterações pendentes para os outros idiomas. Concluir primeiro essas atualizações mantém as traduções de destino existentes e as novas alinhadas com a mesma versão revista da origem.

Em seguida, adicione o idioma de destino à configuração do projeto instalado, autenticado e associado e verifique o trabalho previsto para os ficheiros em falta:

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

A estimativa não traduz nada nem cria qualquer tarefa, mas envia para o servidor os ficheiros que aí faltam, para efeitos de planeamento. Não funciona sem ligação à Internet nem garante um preço. O preenchimento retroativo percorre os padrões configurados e cria os ficheiros de destino em falta; não preenche novas chaves num ficheiro de destino existente. Assim que o novo idioma estiver atualizado, as alterações normais posteriores à origem utilizam lingo push --wait com base na versão de referência guardada.

Nos catálogos XCStrings partilhados, o trabalho é planeado por idioma dentro de um único ficheiro; inspecione as novas entradas através do workflow de iOS.

Se o pedido tiver de abranger apenas um idioma, restrinja targetLocales num ramo controlado ou na configuração de uma tarefa e reponha a lista completa no final. Não adicione a opção de forçar apenas para abranger o novo idioma: essa opção volta a traduzir os destinos existentes no âmbito definido e pode substituir texto já revisto. Enviar documenta essas distinções; a referência de idiomas da CLI v0 descreve as opções dessa geração anterior.

Definir os mesmos limites para um assistente #

Um agente pode inspecionar a estrutura, propor orientações para o idioma e preparar as alterações à configuração. Especifique se pode alterar ficheiros locais, definições do motor de localização pertencentes à organização ou ambos. Delegação distingue esses âmbitos de autorização.

Peça-lhe que explique quais os modelos principais e alternativos aplicáveis e que distinga as orientações partilhadas das específicas de cada idioma. Confirme o estado guardado antes de comparar os resultados. Resolução do idioma explica a seleção; a preferência por um modelo não é uma medida de referência da qualidade linguística.

Verificar o resultado para o novo público #

Compare os caminhos devolvidos e as diferenças com o âmbito pretendido. As traduções de destino já aceites devem permanecer inalteradas, a menos que uma atualização da origem ou uma correção autorizada justifique a alteração. Valide as variáveis, as variantes de plural e os metadados do idioma com as ferramentas de recursos da aplicação.

Carregue conteúdo representativo no novo idioma. Além do significado, verifique o recurso a alternativas, o conteúdo que ultrapassa os limites e a direção de apresentação. Guarde a versão da origem e o resultado para medição antes de alargar a cobertura.

Remover um idioma da configuração impede que seja selecionado para novos trabalhos; não elimina recursos nem rotas em tempo de execução. Decida essas alterações separadamente, sobretudo quando um único catálogo partilhado contém a origem e vários idiomas.