Localizar uma aplicação React Native
Traduza um catálogo de mensagens JSON existente com a CLI e carregue os ficheiros de idioma gerados na sua aplicação React Native.
As aplicações React Native podem usar react-i18next com ficheiros de tradução JSON. O Lingo.dev traduz esses ficheiros através de um motor de localização configurado, enquanto a biblioteca de mensagens já utilizada na aplicação seleciona o idioma e apresenta as mensagens.
Este workflow parte de um catálogo existente com chaves. Mantenha as chaves das mensagens, a sintaxe de interpolação, a convenção de plurais e a configuração em tempo de execução.
Configurar o catálogo de origem #
Para um ficheiro de origem em src/locales/en.json, inicialize a CLI a partir da raiz do projeto:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr,de,ja --files 'src/locales/en.json' --yes
lingo linkO ficheiro .lingo/config.json resultante tem a estrutura abaixo. Mantenha os IDs reais da organização e do motor gerados durante a associação:
{
"orgId": "org_...",
"engineId": "eng_...",
"sourceLocale": "en",
"targetLocales": ["es", "fr", "de", "ja"],
"files": [{ "pattern": "src/locales/en.json" }]
}A CLI identifica o formato JSON pela extensão e determina os caminhos de destino, como src/locales/es.json. Selecione apenas catálogos de origem; os ficheiros de destino gerados não devem ser usados como origens adicionais. Se a aplicação usar vários ficheiros, adicione uma entrada para cada espaço de nomes de origem.
Traduzir e carregar as mensagens #
Crie os ficheiros de destino em falta:
lingo push --backfill-missing --waitQuando o processo terminar, verifique o JSON gerado. Inclua os catálogos de destino nas importações de recursos ou no carregador que a aplicação já utiliza e registe-os no idioma e no espaço de nomes usados pelo react-i18next. A configuração em tempo de execução e o targetLocales da CLI devem definir os mesmos idiomas suportados.
Abra um ecrã num idioma de destino, num dispositivo ou emulador. Teste um rótulo, um valor interpolado e as formas de plural da aplicação. Confirme que a aplicação carrega o catálogo de destino, em vez de apresentar as mensagens no idioma de origem como alternativa, sem qualquer aviso.
Manter a sincronização após alterações na origem #
Inclua a configuração, a origem, os ficheiros de destino aceites e o .lingo/lock.json no mesmo commit. Depois de editar as mensagens de origem, execute:
lingo push --waitReveja os catálogos alterados e repita as verificações nos ecrãs antes do lançamento. Para automatizar o processo, use a GitHub App ou o workflow de CI. As secções Controlos do formato JSON e Preservar traduções revistas explicam o comportamento dos ficheiros e a sua obtenção.