Flutter 国际化:从 ARB 到页面文案

说明 Flutter Intl 项目的 ARB 文件、文案生成与语言切换,区分生成代码和页面状态。

适用版本

原文采用 2021 年 Flutter Intl 插件流程,属于既有项目维护记录。

本文目录
  1. 文案与生成代码分开
  2. ARB 字段和占位符
  3. 接入 MaterialApp
  4. 在页面中使用
  5. 参考

原项目使用 Flutter Intl 插件,把 ARB 文案生成成 Dart 访问方法。这个流程适合维护已经使用 S.of(context) 的项目;Flutter 官方的 gen-l10n 使用另一套生成配置,两种方式的目录和类名不能混用。

文案与生成代码分开

Flutter Intl 项目常见目录如下:

text
lib/
  l10n/
    intl_en.arb
    intl_zh.arb
  generated/
    l10n.dart
    intl/

编辑 l10n 中的 ARB,生成目录交给工具维护。直接改 messages_zh.dart,下次生成会覆盖改动。

项目需要 Flutter 提供的组件本地化委托:

yaml
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 的项目也可运行它的生成入口:

sh
dart run intl_utils:generate

ARB 字段和占位符

英文 intl_en.arb:

json
{
  "@@locale": "en",
  "hello": "Hello",
  "greeting": "Hello {name}",
  "@greeting": {
    "description": "Greeting shown on the home page",
    "placeholders": {"name": {"type": "String"}}
  }
}

中文 intl_zh.arb:

json
{
  "@@locale": "zh",
  "hello": "你好",
  "greeting": "你好,{name}"
}

同一文案在各语言中使用同一个键。占位符名称与类型也保持一致,由生成器负责对应的方法参数。

接入 MaterialApp

dart
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 不足以完整管理应用语言。

在页面中使用

dart
Text(S.of(context).hello)
Text(S.of(context).greeting('Rhyme'))

应用文本来自生成类,日期、数字和复数还需要相应的本地化规则。新增语言后,同时维护原生应用的语言声明与需要翻译的系统权限文案。

参考

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。