Verificar a localização em React durante a revisão de código

Use a extração, as verificações dos catálogos, o TypeScript e a compilação da aplicação para detetar diferentes falhas de localização antes da integração.

Uma mensagem alterada em React chega a quem a lê através do código-fonte, da extração, de um catálogo de destino e do mecanismo de carregamento da aplicação. Reveja todo esse percurso, além do texto. Uma tradução correta associada a uma identidade desatualizada nunca é apresentada; o recurso ao texto de origem pode ocultar uma tradução em falta e, ainda assim, manter o ecrã utilizável.

Este método aplica-se ao pacote React atual, com catálogos JSONC extraídos pela CLI. Combine as verificações de extração da CLI com as verificações de compilação e de renderização do próprio projeto.

Inspecionar primeiro a alteração no código-fonte #

Leia a nova mensagem de origem como uma instrução ou afirmação dirigida ao utilizador. Depois, leia o respetivo contexto. «Botão» descreve uma forma; «Cancelar um pagamento agendado antes do envio» explica a ação cujo significado tem de ser preservado. Tanto o texto de origem como o contexto contribuem para a identidade, pelo que uma alteração apenas ao contexto pode exigir uma nova entrada de destino.

Reveja os marcadores de posição como valores com uma finalidade estável. Quem traduz deve poder mudar a posição do nome de uma pessoa ou de um montante sem alterar a respetiva identidade. No texto formatado, mantenha a navegação e o comportamento dos componentes no código e traduza a frase em torno das etiquetas nomeadas. Consulte as APIs exatas em Mensagens e Texto formatado.

Verificar a extração antes dos catálogos de destino #

No diretório do projeto pretendido, com a CLI instalada:

sh
lingo extract --check
lingo check

Use as mesmas opções --src, --source-locale, --out e --types que o comando de extração do projeto. O idioma de origem predefinido é en; a configuração de localização não altera a predefinição desse comando. Em seguida, execute a verificação de TypeScript e a compilação de produção do repositório, incluindo as declarações geradas.

Falha a introduzir num cenário de teste local para revisãoVerificação de controlo e resultados esperados
Alterar uma mensagem de origem sem voltar a gerar os catálogos ou as declarações.extract --check compara o resultado gerado e falha se estiver desatualizado.
Omitir o contexto obrigatório numa mensagem extraída.check assinala o problema de extração/contexto; inspecione o código-fonte para corrigir o significado.
Deixar uma entrada em falta ou vazia num catálogo JSONC de destino existente.check assinala a tradução em falta no catálogo encontrado.
Deixar as declarações geradas desatualizadas.A extração/verificação deteta a discrepância no conteúdo gerado; o TypeScript verifica separadamente a utilização na aplicação.
Provocar uma falha numa importação de idioma ou na integração com a estrutura de desenvolvimento.A compilação efetiva da aplicação deverá revelar a falha de integração.

Use um cenário de teste local ao configurar estas verificações pela primeira vez. extract --check termina com êxito mesmo quando não encontra ficheiros de código-fonte, por isso confirme que o diretório indicado contém o código pretendido. Caso contrário, um resultado positivo pode significar que a verificação não analisou nada.

Verificar explicitamente a cobertura dos idiomas obrigatórios #

Quando os padrões files em .lingo/config.json correspondem ao catálogo de origem (por exemplo, locales/en.jsonc), lingo check também exige todos os ficheiros dos idiomas de destino configurados. O padrão escrito por lingo init --yes, locales/en.json, não corresponde a um catálogo .jsonc, pelo que, com esse padrão, só são executadas as verificações de React. Uma chave em falta só é assinalada nos catálogos JSONC de destino existentes. Durante a revisão, compare a lista de idiomas obrigatórios com os ficheiros e as importações. Remova temporariamente uma entrada de destino num cenário de teste local para ver como o recurso ao texto de origem se manifesta no ecrã.

Leia pares representativos de mensagens de origem e de destino para verificar o significado, sobretudo quando há alterações nas promessas ou nos termos do produto. Uma verificação de consistência JSONC sem erros não avalia esse significado. Os ficheiros ARB, o XML de Android, os catálogos Apple e os documentos estáticos exigem validação nos respetivos formatos, em vez desta verificação de cobertura específica de React.

Resolver as diferenças sem destruir o conteúdo revisto #

Volte a gerar o conteúdo desatualizado com lingo extract, inspecione as entradas adicionadas e órfãs e traduza as alterações necessárias. Preserve o texto de destino já revisto e o bloqueio de localização. A remoção de entradas órfãs altera os catálogos e deve ser revista separadamente da alteração à mensagem de origem.

Escolha se as traduções chegam ao ramo do código-fonte ou através de um PR de tradução separado. O guia de CI explica as vantagens e limitações das opções de entrega e as diferenças da App gerida. Em qualquer dos modelos, mantenha a permissão de integração separada da permissão de execução e da aceitação do conteúdo.

Para terminar, carregue o ecrã alterado num idioma de destino, com valores representativos. Siga as ligações no texto formatado, inspecione o comportamento de recurso ao texto de origem e compare a mensagem apresentada com a ação pretendida. A revisão fica concluída quando tanto o percurso da mensagem no programa como o texto tiverem sido examinados.