> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 本地化移动应用

四个出厂语言、类型检查的文案目录，以及英文兜底。

## 目录如何运作

应用在 apps/mobile/src/i18n 附带英文、德文、西班牙文与法文目录 —— 每种语言一个经类型检查的 MobileCatalog，通过 t(key, vars) 以点分路径与 {name} 插值查找。某语言缺失的键回退到英文条目；复数字符串通过 Intl.PluralRules 选择形态。


## 如何选定语言

设备语言在运行时经 Intl API 解析，按语言前缀匹配，并回退到英文 —— pt-BR 设备会看到英文，因为葡萄牙语不在 MOBILE_LOCALES 中。


## 新增文案与语言

每个新键都要加入全部四个目录 —— 共享目录类型会让缺键的语言过不了类型检查。增加第五种语言意味着扩展 MobileLocale 与 MOBILE_LOCALES 并编写完整目录。移动端目录与 Web 应用的 i18n 相互独立：没有任何自动同步，两端都存在的文案要在两处分别翻译。


## 验证与排障

把设备语言依次切到每种出厂语言再加一个不受支持的语言，并在每个目录中检查离线横幅相对时间这类复数字符串。界面上出现原始点分键意味着该键在所有目录中都缺失，而不是某个语言没翻译。


## 下一篇

[模块概览](https://supastack.dev/zh/docs/modules.md)