本地化 React Native 应用

使用 CLI 翻译现有的 JSON 消息目录,并在 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 结构如下。请保留关联时生成的实际组织 ID 和引擎 ID:

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 使用的语言和命名空间进行注册。运行时配置与 CLI 的 targetLocales 必须指定相同的受支持语言。

在设备或模拟器上以目标语言打开一个页面。测试一个标签、一个插值,以及应用的复数形式。确认页面加载的是目标消息目录,而不是在未提示的情况下回退显示源语言内容。

保持后续源内容变更同步 #

将配置、源文件、已接受的目标文件和 .lingo/lock.json 一起提交。编辑源消息后,运行:

sh
lingo push --wait

审核有变更的消息目录,并在发布前再次检查页面。如需自动化,请使用 GitHub App 或 CI 工作流。JSON 格式控制和保留已审核的翻译介绍了文件的处理行为和检索方式。