Как локализовать приложение на React Native

Переведите существующий JSON-каталог сообщений с помощью CLI и загрузите созданные языковые файлы в приложение на React Native.

В приложениях на React Native можно использовать react-i18next с JSON-файлами переводов. Lingo.dev переводит эти файлы с помощью настроенного движка локализации, а библиотека сообщений, которую вы уже используете, выбирает локаль и показывает сообщения.

Этот рабочий процесс начинается с готового каталога сообщений с ключами. Сохраните ключи сообщений, синтаксис подстановок, правила записи форм множественного числа и настройки среды выполнения.

Настройте исходный каталог #

Если исходный каталог находится в src/locales/en.json, инициализируйте CLI из корня проекта:

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

Созданный .lingo/config.json выглядит так. Оставьте в нём ИД организации и движка, полученные при привязке:

json
{
  "orgId": "org_...",
  "engineId": "eng_...",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [{ "pattern": "src/locales/en.json" }]
}

CLI определяет формат JSON по расширению и формирует пути к файлам переводов, например src/locales/es.json. Выбирайте только исходные каталоги. Созданные файлы переводов не должны становиться дополнительными источниками. Если приложение использует несколько файлов, добавьте запись для каждого исходного пространства имён.

Переведите и загрузите сообщения #

Создайте недостающие файлы переводов:

sh
lingo push --backfill-missing --wait

Когда перевод завершится, проверьте созданные JSON-файлы. Подключите каталоги переводов через существующие импорты ресурсов приложения или загрузчик и зарегистрируйте их для языка и пространства имён, используемых в react-i18next. Настройки среды выполнения и targetLocales в CLI должны задавать один и тот же набор поддерживаемых языков.

Откройте экран на целевом языке на устройстве или в эмуляторе. Проверьте подпись, значение с подстановкой и формы множественного числа в приложении. Убедитесь, что приложение загружает каталог переводов, а не подставляет незаметно для вас текст на исходном языке.

Синхронизируйте переводы при изменении исходных сообщений #

Сохраняйте конфигурацию, исходный каталог, принятые переводы и .lingo/lock.json в одном коммите. После изменения исходных сообщений выполните:

sh
lingo push --wait

Проверьте изменённые каталоги и перед выпуском повторите проверки на экране. Для автоматизации используйте GitHub App или рабочий процесс CI. Подробнее о работе с файлами и получении переводов — в разделах «Настройки формата JSON» и «Сохранение проверенных переводов».