本地化 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 格式控制和保留已审核的翻译介绍了文件的处理行为和检索方式。