> ## 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-tw/docs/mobile/configuration.md)