Flutter国际化插件ezi18n的使用

EzI18n 是一个轻量级的国际化（i18n）库，专为 Flutter 设计。它简化了翻译管理，并支持动态参数替换，使得多语言应用开发变得轻松愉快。🚀

特性 🛠️

• 🌍 支持通用语言（如 pt）和特定语言（如 pt_BR）。
• 🔄 动态参数替换（如 @{name}）。
• 🛡️ 缺失翻译的回退机制。
• 📦 与 Flutter 的本地化框架无缝集成。

入门指南 🏁

安装 📥

在 pubspec.yaml 文件中添加 EzI18n：

dependencies:
  ezi18n: ^1.0.0

然后运行以下命令获取依赖项：

flutter pub get

注意事项 📝

对于原生 Widget 的翻译，你需要使用 flutter_localizations 包来加载委托，如示例代码所示。

使用 🚀

1. 定义翻译 🗂️

创建一个实现 EzMessages 接口的类来定义翻译内容。

import 'package:ezi18n/ezi18n.dart';

class AppMessages implements EzMessages {
  [@override](/user/override)
  Map<String, Map<String, String>> get keys => {
        'en': {'greeting': 'Hello, @{name}!', 'farewell': 'Goodbye, @{name}!'},
        'pt': {'greeting': 'Olá, @{name}!', 'farewell': 'Adeus, @{name}!'},
        'pt_BR': {'greeting': 'Olá, @{name}!', 'farewell': 'Tchau, @{name}!'},
      };
}

2. 在应用中设置本地化 ⚙️

配置 MaterialApp，并添加 EzI18nDelegate 以启用多语言支持。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      locale: Locale('en'), // 设置默认语言
      localizationsDelegates: [
        EzI18nDelegate(AppMessages()), // 添加 EzI18n 的翻译委托
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
        GlobalCupertinoLocalizations.delegate,
      ],
      supportedLocales: [Locale('en'), Locale('pt'), Locale('pt', 'BR')], // 支持的语言列表
      home: MyHomePage(),
    );
  }
}

3. 在页面中使用翻译 📝

通过调用 .tr() 方法来使用翻译，并传递参数。

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

class MyHomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('greeting'.tr(context, params: {'name': 'Alice'})), // 动态替换参数
      ),
      body: Center(
        child: Text('greeting'.tr(context, params: {'name': 'Bob'})),
      ),
    );
  }
}

示例代码

以下是完整的示例代码，展示了如何使用 EzI18n 实现多语言支持。

import 'package:example/messages.dart'; // 引入自定义的翻译文件
import 'package:ezi18n/ezi18n.dart';
import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';

import 'home_page.dart';

void main() {
  runApp(MyApp(
    messages: AppMessages(), // 自定义翻译类
    supportedLocales: [
      Locale('en'),
      Locale('pt'),
      Locale('pt', 'BR'),
    ],
    locale: Locale('pt', 'BR'), // 默认语言
  ));
}

class MyApp extends StatefulWidget {
  final Locale locale;
  final EzMessages messages;
  final List<Locale> supportedLocales;

  MyApp({
    required this.messages,
    required this.supportedLocales,
    required this.locale,
  });

  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  Locale _currentLocale;

  _MyAppState() : _currentLocale = Locale('en'); // 初始语言

  [@override](/user/override)
  void initState() {
    _currentLocale = widget.locale;
    super.initState();
  }

  void _changeLanguage(Locale locale) {
    setState(() {
      _currentLocale = locale;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      locale: _currentLocale,
      debugShowCheckedModeBanner: false,
      localizationsDelegates: [
        EzI18nDelegate(widget.messages), // 加载自定义翻译
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
        GlobalCupertinoLocalizations.delegate,
      ],
      supportedLocales: widget.supportedLocales,
      home: MyHomePage(
        onChangeLanguage: _changeLanguage,
        supportedLocales: widget.supportedLocales,
        currentLocale: _currentLocale,
      ),
    );
  }
}