Localize um app React Native
Traduza um catálogo de mensagens JSON existente com a CLI e carregue os arquivos de idioma gerados no seu app React Native.
Apps React Native podem usar react-i18next com arquivos de tradução em JSON. O Lingo.dev traduz esses arquivos usando um engine de localização configurado, enquanto a biblioteca de mensagens que você já usa seleciona o idioma e renderiza as mensagens.
Este workflow parte de um catálogo existente organizado por chaves. Preserve as chaves das mensagens, a sintaxe de interpolação, a convenção de plurais e a configuração de execução.
Configure o catálogo de origem #
Com o catálogo de origem em src/locales/en.json, inicialize a CLI na 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 .lingo/config.json gerado tem a estrutura abaixo. Mantenha os IDs reais da organização e do engine gerados na vinculaçã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 caminhos de destino como src/locales/es.json. Selecione apenas catálogos de origem; os arquivos de destino gerados não devem ser usados como origens adicionais. Se o app usar vários arquivos, adicione uma entrada para cada namespace de origem.
Traduza e carregue as mensagens #
Crie os arquivos de destino que faltam:
lingo push --backfill-missing --waitAo terminar, confira o JSON gerado. Inclua os catálogos de destino nas importações de recursos ou no carregador que o app já usa e registre-os com o idioma e o namespace usados pelo react-i18next. A configuração de execução e o targetLocales da CLI devem especificar os mesmos idiomas compatíveis.
Abra uma tela em um idioma de destino em um dispositivo ou emulador. Teste um rótulo, um valor interpolado e as formas de plural do app. Confirme que o app carrega o catálogo de destino, em vez de recorrer ao idioma de origem sem avisar.
Mantenha as próximas alterações na origem sincronizadas #
Faça um único commit com a configuração, a origem, os arquivos de destino aceitos e .lingo/lock.json. Depois de editar as mensagens de origem, execute:
lingo push --waitRevise os catálogos alterados e repita os testes nas telas antes do lançamento. Para automatizar, use o GitHub App ou o workflow de CI. As seções Controles de formato JSON e Preservação de traduções revisadas explicam o comportamento dos arquivos e a recuperação das traduções.