本地化
優先級:P1 (標準)
使用 easy_localization 實現一致的多語言支援。
格式選擇
- CSV(建議給與翻譯團隊協作的情況):
- 非技術編輯人員可以輕鬆更新
- 原生 Google Sheets 相容性,透過
sheet_loader_localization - 儲存於
assets/langs/(常見慣例)
- JSON(開發者友善):
- 支援巢狀結構(例如
items_count.zero) - IDE 驗證與自動補全
- 儲存於
assets/translations/
- 支援巢狀結構(例如
兩種格式與 easy_localization 搭配使用時效果完全相同。
結構
# CSV 格式(Google Sheets 工作流程)
assets/langs/langs.csv
# 或 JSON 格式(巢狀鍵值)
assets/translations/
├── en.json
└── vi.json
實作指南
- 初始化:使用
EasyLocalization包裹根元件。務必使用await EasyLocalization.ensureInitialized()。 - 查詢:在字串上使用
.tr()擴充方法(例如'welcome'.tr())。 - 語言環境:透過
context.setLocale(Locale('code'))進行切換。 - 參數:使用
{}佔位符;透過tr(args: [...])傳遞。 - 計數:對於數量使用
plural()。 - 試算表同步:使用
sheet_loader_localization從 Google Sheets 自動產生 CSV/JSON。
反模式
- 硬編碼:UI 中不要有原始字串;應使用鍵值。
- 手動 L10n:避免使用標準的
Localizations.of;應使用 GetX 或easy_localization的上下文方法。 - 不同步:保持所有語言檔案中的鍵值完全相同。
參考資料與範例
關於設定與 Google Sheets 自動化: 請參閱 references/REFERENCE.md。
相關主題
idiomatic-flutter | widgets