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:

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr,de,ja --files 'src/locales/en.json' --yes
lingo link

O .lingo/config.json gerado tem a estrutura abaixo. Mantenha os IDs reais da organização e do engine gerados na vinculação:

json
{
  "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:

sh
lingo push --backfill-missing --wait

Ao 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:

sh
lingo push --wait

Revise 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.