一、为什么需要国际化支持

开发一个应用时，如果希望它被全球用户使用，那么多语言支持就是必不可少的。想象一下，你的应用在中国显示中文，在美国显示英文，在日本显示日文，这样用户体验会更好。Dart 作为 Flutter 的主要开发语言，自然也提供了完善的国际化方案。

在 Dart 中，我们可以通过 intl 包来实现国际化。这个包不仅支持文本翻译，还能处理日期、数字、货币等格式的本地化。接下来，我们就一步步看看如何实现一个完整的国际化方案。

二、准备工作：添加依赖

首先，我们需要在 pubspec.yaml 文件中添加 intl 依赖：

dependencies:
  flutter:
    sdk: flutter
  intl: ^0.18.0  # 使用最新稳定版

然后运行 flutter pub get 来安装依赖。

三、创建翻译文件

国际化最核心的部分就是翻译文件。我们需要为每种语言创建一个 .arb（Application Resource Bundle）文件，这是一种 JSON 格式的文件，专门用于存储翻译内容。

假设我们支持英文和中文，那么可以创建以下两个文件：

  1. lib/l10n/app_en.arb（英文翻译）
  2. lib/l10n/app_zh.arb（中文翻译）

app_en.arb

{
  "@@locale": "en",
  "helloWorld": "Hello, World!",
  "@helloWorld": {
    "description": "A simple greeting message."
  },
  "welcomeMessage": "Welcome, {name}!",
  "@welcomeMessage": {
    "description": "A personalized welcome message.",
    "placeholders": {
      "name": {}
    }
  }
}

app_zh.arb

{
  "@@locale": "zh",
  "helloWorld": "你好，世界！",
  "@helloWorld": {
    "description": "简单的问候语。"
  },
  "welcomeMessage": "欢迎, {name}!",
  "@welcomeMessage": {
    "description": "个性化的欢迎消息。",
    "placeholders": {
      "name": {}
    }
  }
}

.arb 文件不仅存储翻译文本，还能提供注释和占位符信息，非常方便。

四、生成 Dart 本地化代码

有了翻译文件后，我们需要用 flutter_localizations 和 intl_translation 工具来生成 Dart 代码。

首先，修改 pubspec.yaml，添加 flutter_localizations 和开发依赖：

dependencies:
  flutter:
    sdk: flutter
  intl: ^0.18.0
  flutter_localizations:
    sdk: flutter

dev_dependencies:
  intl_translation: ^0.18.0

然后运行以下命令生成 Dart 代码：

flutter pub pub run intl_translation:extract_to_arb --output-dir=lib/l10n lib/localization.dart
flutter pub pub run intl_translation:generate_from_arb --output-dir=lib/l10n --no-use-deferred-loading lib/localization.dart lib/l10n/app_*.arb

这会生成 messages_all.dart 和 messages_<locale>.dart 文件，用于加载不同语言的翻译。

五、实现本地化类

接下来，我们需要创建一个 Localization 类来管理翻译：

import 'package:flutter/material.dart';
import 'package:intl/intl.dart';
import 'messages_all.dart';  // 自动生成的代码

class Localization {
  static Future<Localization> load(Locale locale) async {
    final name = locale.countryCode?.isEmpty ?? true
        ? locale.languageCode
        : locale.toString();
    final localeName = Intl.canonicalizedLocale(name);

    // 加载对应的翻译文件
    await initializeMessages(localeName);
    Intl.defaultLocale = localeName;
    return Localization();
  }

  static Localization? of(BuildContext context) {
    return Localizations.of<Localization>(context, Localization);
  }

  String get helloWorld => Intl.message(
        'Hello, World!',
        name: 'helloWorld',
        desc: 'A simple greeting message.',
      );

  String welcomeMessage(String name) => Intl.message(
        'Welcome, $name!',
        name: 'welcomeMessage',
        desc: 'A personalized welcome message.',
        args: [name],
      );
}

六、配置 MaterialApp 支持多语言

最后，我们需要在 MaterialApp 中配置本地化支持：

import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';
import 'localization.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      localizationsDelegates: [
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
        GlobalCupertinoLocalizations.delegate,
        LocalizationDelegate(),  // 自定义的本地化代理
      ],
      supportedLocales: [
        const Locale('en', ''),  // 英文
        const Locale('zh', ''),  // 中文
      ],
      home: MyHomePage(),
    );
  }
}

class LocalizationDelegate extends LocalizationsDelegate<Localization> {
  @override
  bool isSupported(Locale locale) => ['en', 'zh'].contains(locale.languageCode);

  @override
  Future<Localization> load(Locale locale) => Localization.load(locale);

  @override
  bool shouldReload(LocalizationDelegate old) => false;
}

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final l10n = Localization.of(context)!;

    return Scaffold(
      appBar: AppBar(title: Text('Internationalization Demo')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text(l10n.helloWorld),
            Text(l10n.welcomeMessage('Flutter Developer')),
          ],
        ),
      ),
    );
  }
}

七、应用场景

国际化方案适用于：

  • 面向全球市场的移动应用
  • 需要动态切换语言的 Web 应用
  • 企业级管理系统，支持多语言员工使用

八、技术优缺点

优点：

  1. 标准化：使用 .arb 文件，符合国际化标准。
  2. 可扩展：支持动态添加新语言，只需新增 .arb 文件即可。
  3. 功能全面：不仅能翻译文本，还能处理日期、数字等本地化格式。

缺点：

  1. 配置较复杂：需要生成代码，初次使用可能觉得繁琐。
  2. 依赖较多：需要 intl 和 flutter_localizations 支持。

九、注意事项

  1. 翻译文件管理：建议将 .arb 文件放在统一目录，方便维护。
  2. 占位符处理：确保翻译文件中的占位符名称一致，否则会导致运行时错误。
  3. 测试覆盖：务必测试所有支持的语言，避免遗漏翻译。

十、文章总结

Dart 的国际化方案虽然配置稍显复杂，但功能强大且灵活。通过 intl 和 .arb 文件，我们可以轻松实现多语言支持。如果你的应用需要面向全球用户，不妨试试这个方案！