适用版本
原文采用 2021 年 Flutter Intl 插件流程,属于既有项目维护记录。
原项目使用 Flutter Intl 插件,把 ARB 文案生成成 Dart 访问方法。这个流程适合维护已经使用 S.of(context) 的项目;Flutter 官方的 gen-l10n 使用另一套生成配置,两种方式的目录和类名不能混用。
文案与生成代码分开
Flutter Intl 项目常见目录如下:
lib/
l10n/
intl_en.arb
intl_zh.arb
generated/
l10n.dart
intl/
编辑 l10n 中的 ARB,生成目录交给工具维护。直接改 messages_zh.dart,下次生成会覆盖改动。
项目需要 Flutter 提供的组件本地化委托:
dependencies:
flutter_localizations:
sdk: flutter
flutter_intl:
enabled: true
main_locale: en
arb_dir: lib/l10n
output_dir: lib/generated
原流程通过 IDE 的 Flutter Intl 菜单初始化项目、添加 Locale。已配置 intl_utils 的项目也可运行它的生成入口:
dart run intl_utils:generate
ARB 字段和占位符
英文 intl_en.arb:
{
"@@locale": "en",
"hello": "Hello",
"greeting": "Hello {name}",
"@greeting": {
"description": "Greeting shown on the home page",
"placeholders": {"name": {"type": "String"}}
}
}
中文 intl_zh.arb:
{
"@@locale": "zh",
"hello": "你好",
"greeting": "你好,{name}"
}
同一文案在各语言中使用同一个键。占位符名称与类型也保持一致,由生成器负责对应的方法参数。
接入 MaterialApp
import 'package:flutter_localizations/flutter_localizations.dart';
import 'generated/l10n.dart';
MaterialApp(
locale: selectedLocale,
localizationsDelegates: const [
S.delegate,
GlobalMaterialLocalizations.delegate,
GlobalWidgetsLocalizations.delegate,
GlobalCupertinoLocalizations.delegate,
],
supportedLocales: S.delegate.supportedLocales,
home: const HomePage(),
)
selectedLocale 是由应用状态持有的 Locale?,null 表示由系统语言参与匹配。用户选择语言后,更新这个状态并重建 MaterialApp;只在某个页面里调用 S.load 不足以完整管理应用语言。
在页面中使用
Text(S.of(context).hello)
Text(S.of(context).greeting('Rhyme'))
应用文本来自生成类,日期、数字和复数还需要相应的本地化规则。新增语言后,同时维护原生应用的语言声明与需要翻译的系统权限文案。


