Как локализовать приложение на React Native
Переведите существующий JSON-каталог сообщений с помощью CLI и загрузите созданные языковые файлы в приложение на React Native.
В приложениях на React Native можно использовать react-i18next с JSON-файлами переводов. Lingo.dev переводит эти файлы с помощью настроенного движка локализации, а библиотека сообщений, которую вы уже используете, выбирает локаль и показывает сообщения.
Этот рабочий процесс начинается с готового каталога сообщений с ключами. Сохраните ключи сообщений, синтаксис подстановок, правила записи форм множественного числа и настройки среды выполнения.
Настройте исходный каталог #
Если исходный каталог находится в src/locales/en.json, инициализируйте CLI из корня проекта:
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 выглядит так. Оставьте в нём ИД организации и движка, полученные при привязке:
{
"orgId": "org_...",
"engineId": "eng_...",
"sourceLocale": "en",
"targetLocales": ["es", "fr", "de", "ja"],
"files": [{ "pattern": "src/locales/en.json" }]
}CLI определяет формат JSON по расширению и формирует пути к файлам переводов, например src/locales/es.json. Выбирайте только исходные каталоги. Созданные файлы переводов не должны становиться дополнительными источниками. Если приложение использует несколько файлов, добавьте запись для каждого исходного пространства имён.
Переведите и загрузите сообщения #
Создайте недостающие файлы переводов:
lingo push --backfill-missing --waitКогда перевод завершится, проверьте созданные JSON-файлы. Подключите каталоги переводов через существующие импорты ресурсов приложения или загрузчик и зарегистрируйте их для языка и пространства имён, используемых в react-i18next. Настройки среды выполнения и targetLocales в CLI должны задавать один и тот же набор поддерживаемых языков.
Откройте экран на целевом языке на устройстве или в эмуляторе. Проверьте подпись, значение с подстановкой и формы множественного числа в приложении. Убедитесь, что приложение загружает каталог переводов, а не подставляет незаметно для вас текст на исходном языке.
Синхронизируйте переводы при изменении исходных сообщений #
Сохраняйте конфигурацию, исходный каталог, принятые переводы и .lingo/lock.json в одном коммите. После изменения исходных сообщений выполните:
lingo push --waitПроверьте изменённые каталоги и перед выпуском повторите проверки на экране. Для автоматизации используйте GitHub App или рабочий процесс CI. Подробнее о работе с файлами и получении переводов — в разделах «Настройки формата JSON» и «Сохранение проверенных переводов».