用途
该技能文档用于指导 React Native 与 Expo 应用的国际化(i18n)实现。资料给出的目标环境为:Hermes 上的 React Native 0.8x、Expo SDK 54–58、i18next 26 和 react-i18next 17。相同模式也适用于 Lingui、FormatJS 等其他库,区别仅在于翻译 API。
主要内容结构
资料将内容分为三部分参考:
- 核心参考(core-setup):区域语言检测、i18next + react-i18next 初始化、资源布局、类型化键、语言切换与持久化。
- 功能参考:
- 复数与格式化(features-formatting):复数类别、插值、Hermes 上的 Intl 日期/数字/货币/相对时间、polyfill。
- RTL(features-rtl):I18nManager、start/end 样式、图标镜像、Expo 的 supportsRTL、方向变更后重载。
- 最佳实践(best-practices-workflow):键命名、提取、缺失键检查、伪本地化、按应用语言设置、商店元数据。
关键建议
资料列出以下要点:
- 从操作系统读取区域语言:使用 expo-localization 的 getLocales(),或 react-native-localize 的 getLocales() / findBestLanguageTag();不要解析 navigator.language。
- 使用 Intl 进行格式化,而不是字符串拼接;日期、数字、货币和复数取决于区域规则,而不仅是语言。
- 每条消息一个键,使用完整句子,不拼接片段,并为译者提供上下文。
- 使用 start/end 而非 left/right;开启 RTL 时布局会自动镜像。
- 方向变更需要重载:I18nManager.forceRTL 仅在重启 JS bundle 后生效。
- 以原生方式声明支持的区域语言:在 expo-localization 插件中设置 supportedLocales,可在 Android 13+ 和 iOS 上启用按应用语言设置。
使用方式与限制
资料未提供具体安装命令、代码示例或分步操作流程,仅给出上述配置要点与参考主题。实际接入时需按所选库(i18next/react-i18next 或 Lingui、FormatJS 等)的 API 自行实现。资料未说明收费、价格、平台支持范围之外的功能或效果。