For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/mobile/i18n.md (or send Accept: text/markdown).
本地化移动应用
四个出厂语言、类型检查的文案目录,以及英文兜底。
目录如何运作
应用在 apps/mobile/src/i18n 附带英文、德文、西班牙文与法文目录 —— 每种语言一个经类型检查的 MobileCatalog,通过 t(key, vars) 以点分路径与 {name} 插值查找。某语言缺失的键回退到英文条目;复数字符串通过 Intl.PluralRules 选择形态。
如何选定语言
设备语言在运行时经 Intl API 解析,按语言前缀匹配,并回退到英文 —— pt-BR 设备会看到英文,因为葡萄牙语不在 MOBILE_LOCALES 中。
新增文案与语言
每个新键都要加入全部四个目录 —— 共享目录类型会让缺键的语言过不了类型检查。增加第五种语言意味着扩展 MobileLocale 与 MOBILE_LOCALES 并编写完整目录。移动端目录与 Web 应用的 i18n 相互独立:没有任何自动同步,两端都存在的文案要在两处分别翻译。
验证与排障
把设备语言依次切到每种出厂语言再加一个不受支持的语言,并在每个目录中检查离线横幅相对时间这类复数字符串。界面上出现原始点分键意味着该键在所有目录中都缺失,而不是某个语言没翻译。