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-tw/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 相互獨立:沒有任何自動同步,兩端都存在的文案要在兩處分別翻譯。
驗證與排障
把裝置語言依次切到每種出廠語言再加一個不受支援的語言,並在每個目錄中檢查離線橫幅相對時間這類複數字串。介面上出現原始點分鍵意味著該鍵在所有目錄中都缺失,而不是某個語言沒翻譯。