本地化
优先级:P1(标准)
使用 easy_localization 实现一致的多语言支持。
格式选择
- CSV(推荐给有翻译团队的团队):
- 非技术编辑可以轻松更新
- 通过
sheet_loader_localization原生支持 Google Sheets - 存储在
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 中不直接使用原始字符串,应使用键。
- 手动本地化:避免使用标准
Localizations.of,改用 GetX 或easy_localization上下文方法。 - 键不同步:确保所有本地化文件中的键完全相同。
参考与示例
关于设置和 Google Sheets 自动化: 请参见 references/REFERENCE.md。
相关主题
idiomatic-flutter | widgets