本地化指南
概述
PubPub 使用 Flutter 的官方本地化方案(flutter_localizations + intl),支持多语言。
支持的语言
| 语言 | 代码 | ARB 文件 |
|---|---|---|
| English | en | lib/l10n/app_en.arb |
| 中文 | zh | lib/l10n/app_zh.arb |
添加新语言
1. 创建 ARB 文件
复制 lib/l10n/app_en.arb 并重命名为 lib/l10n/app_{语言代码}.arb,翻译所有值。
2. 更新配置
在 lib/app.dart 的 supportedLocales 中添加新语言:
dart
supportedLocales: const [
Locale('en'),
Locale('zh'),
Locale('ja'), // 日语
],在 lib/pages/settings_page.dart 的 _showLanguageDialog 中添加新选项:
dart
SimpleDialogOption(
onPressed: () {
ctrl.setLocale(const Locale('ja'));
Navigator.pop(context);
},
child: const Text('日本語'),
),3. 重新生成
bash
flutter gen-l10n4. 更新语言显示名称
在 lib/pages/settings_page.dart 的 _buildLanguageTile 中添加新语言的显示名称:
dart
case 'ja':
langText = '日本語';
break;ARB 文件格式
ARB 文件是 JSON 格式,包含翻译键值对:
json
{
"@@locale": "en",
"hello": "Hello",
"greeting": "Hello, {name}!",
"@greeting": {
"placeholders": {
"name": {
"type": "String"
}
}
}
}占位符
使用 {变量名} 语法定义占位符:
json
{
"version": "Version {version}",
"@version": {
"placeholders": {
"version": {
"type": "String"
}
}
}
}在代码中使用
方法一:使用 context 扩展
dart
import '../common/l10n_ext.dart';
// 在 Widget 中
Text(context.l10n.appTitle)方法二:直接使用
dart
import '../l10n/app_localizations.dart';
// 在 Widget 中
Text(AppLocalizations.of(context)!.appTitle)翻译规范
- 键名:使用 camelCase,语义清晰
- 英文:作为源语言,保持简洁
- 占位符:使用
{name}格式,ARB 中需要定义@key - 复数:使用 ICU 消息格式
- HTML:避免在翻译中使用 HTML 标签
文件结构
lib/l10n/
├── app_en.arb # 英文翻译(源)
├── app_zh.arb # 中文翻译
├── app_localizations.dart # 生成的本地化类
├── app_localizations_en.dart
├── app_localizations_zh.dart
└── untranslated.txt # 未翻译的字符串