flutter 多语言

### 如何在 Flutter 项目中实现多语言支持

#### 创建并配置 `pubspec.yaml` 文件
为了使应用程序能够访问必要的国际化包，在项目的根目录下找到 `pubspec.yaml` 文件，并添加如下依赖项：

dependencies:
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter

这一步骤确保了应用可以利用官方提供的本地化工具[^2]。

#### 导入必要的库
接着，在主文件 `main.dart` 中导入所需的命名空间以便于后续操作：

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

通过上述代码片段，程序获得了对Flutter内置的本地化功能的支持。

#### 支持多种语言和地区设置
定义一个名为 `supportedLocales` 的列表变量来声明App打算覆盖的目标市场及其对应的地区偏好。例如：

final List<Locale> supportedLocales = [
  const Locale('en', ''), // English, no country code
  const Locale('es', ''), // Spanish, no country code
];

此部分指定了哪些语言版本的应用会被构建出来[^1]。

#### 添加自定义资源文件
对于每一个想要支持的新语言创建相应的ARB (Android Resource Bundle) 资源文件夹结构，通常位于 `/lib/l10n/` 下面。这些文件包含了特定文化背景下使用的翻译字符串表单。比如英文版可能是这样的路径:`app_en.arb`,而西班牙语则是`app_es.arb`.

每个 ARB 文件都遵循相同的 JSON 格式的键值对模式存储消息模板。以下是两个例子中的一个:

{
  "helloWorld": "Hello world!"
}

另一个可能看起来像这样:

{
  "helloWorld": "¡Hola mundo!"
}

这种做法允许开发者轻松管理不同地区的文字表述差异[^3]。

#### 修改 `MaterialApp` 构造函数参数
最后也是最重要的一步是在启动入口处调整 `MaterialApp` 小部件的相关属性以启用完整的国际化特性。具体来说就是向其传递三个重要的成员——`localizationsDelegates`,`localeResolutionCallback`以及`supportedLocales`.下面是一个典型的实例展示：

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'My App',
      theme: ThemeData(primarySwatch: Colors.blue),
      home: MyHomePage(),
      localizationsDelegates: [
        GlobalMaterialLocalizations.delegate,
        GlobalCupertinoLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
      ],
      supportedLocales: supportedLocales,
    );
  }
}

这里特别注意的是加入了几个全局性的委托对象用于处理各种UI控件的文字适配工作；同时还将之前准备好的受支持区域集合赋给了对应字段[^4]。