Flutter国际化插件easy_i18n的使用

Flutter国际化插件easy_i18n的使用

easy_i18n 是一个用于在 Flutter 应用程序中实现多语言支持的简单插件。通过这个插件，开发者可以轻松地将多种语言集成到他们的应用程序中。

获取开始

本项目是一个 Dart 包项目，可用于多个 Flutter 或 Dart 项目的代码共享。如果你刚开始使用 Flutter，可以查看官方文档，了解更多教程、示例和移动端开发指南。

示例代码

以下是一个完整的示例，展示了如何使用 easy_i18n 插件来实现多语言支持。

import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:easy_i18n/easy_i18n.dart';

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

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  EasyI18nDelegate easyI18nDelegate;

  @override
  void initState() {
    // 初始化 EasyI18nDelegate，并设置支持的语言
    easyI18nDelegate = EasyI18nDelegate(
      supportedLocales: [
        Locale('en', 'US'),   // 英语
        Locale('pt'),         // 葡萄牙语
        Locale('es'),         // 西班牙语
      ],
    );
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    // 使用 MaterialApp 并配置本地化代理
    return MaterialApp(
      localizationsDelegates: easyI18nDelegate.localizationsDelegates,
      supportedLocales: easyI18nDelegate.supportedLocales,
      localeResolutionCallback: easyI18nDelegate.localeResolutionCallback,
      theme: ThemeData(
        primarySwatch: Colors.blue,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(
          // 使用 EasyI18n.of(context).populate 方法来动态填充文本
          EasyI18n.of(context).populate(
            EasyI18n.of(context).trans('title'),
            {'appName': 'i18n'},
          ),
        ),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            // 显示多语言文本
            Text(
              EasyI18n.of(context).trans('message'),
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headline4,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: EasyI18n.of(context).trans('increment'),
        child: Icon(Icons.add),
      ),
    );
  }
}

解释

1. 初始化：

   • 在 initState 中初始化 EasyI18nDelegate，并指定支持的语言列表（如英语、葡萄牙语和西班牙语）。

2. MaterialApp 配置：

   • 在 MaterialApp 中配置 localizationsDelegates 和 supportedLocales，以便应用能够识别并加载不同语言的资源文件。

3. 多语言文本：

   • 使用 EasyI18n.of(context).trans('key') 方法来获取对应语言的文本。
   • 可以通过 EasyI18n.of(context).populate(key, params) 方法来动态填充文本。

语言资源文件

为了使上述代码正常工作，还需要创建相应的语言资源文件。例如，在 assets/i18n 目录下创建 en.json, pt.json, 和 es.json 文件：

• en.json

  {
    "title": "Welcome to {appName}",
    "message": "You have pushed the button this many times:"
  }
  

• pt.json

  {
    "title": "Bem-vindo ao {appName}",
    "message": "Você pressionou o botão esta quantidade de vezes:"
  }
  

• es.json

  {
    "title": "Bienvenido a {appName}",
    "message": "Has presionado el botón este número de veces:"
  }
  

确保在 pubspec.yaml 文件中添加这些资源文件路径：

flutter:
  assets:
    - assets/i18n/