Flutter国际化工具插件intl_utils_plus的使用

Flutter国际化工具插件intl_utils_plus的使用

intl_utils_plus 是一个用于在 Flutter 应用程序中实现国际化的工具包。它能够自动生成本地化文件，并且支持从 .arb 文件中创建与您的 Flutter 应用程序绑定的翻译。

安装

首先，在你的 pubspec.yaml 文件中添加 intl_utils_plus 依赖：

dependencies:
  intl_utils_plus: ^1.0.0

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

配置插件

在 pubspec.yaml 文件中添加以下配置来启用和配置 intl_utils_plus 插件：

flutter_intl_plus:
  enabled: true
  class_name: S
  main_locale: zh
  arb_dir: lib/l10n
  output_dir: lib/generated
  use_deferred_loading: false

• enabled: 必须设置为 true 才能激活插件。
• class_name: 设置生成的本地化类的名称，默认为 S。
• main_locale: 设置主语言代码，默认为 zh。
• arb_dir: 设置 .arb 文件所在的目录，默认为 lib/l10n。
• output_dir: 设置生成的本地化文件的输出目录，默认为 lib/generated。
• use_deferred_loading: 如果设置为 true，则生成支持延迟加载的本地化代码，默认为 false。

添加 .arb 文件

在 lib/l10n 目录下添加 .arb 文件，例如 intl_zh.arb 或 intl_en.arb。这些文件用于存储不同语言的翻译键值对。示例如下：

{
  "@@locale": "zh",
  "helloWorld": "你好，世界！"
}

运行命令生成代码

为了生成本地化代码，运行以下命令：

flutter pub run intl_utils_plus:generate

这将生成的文件存放在 lib/generated 目录下。你可以通过修改 output_dir 来改变生成文件的位置。

使用本地化字符串

在你的 Flutter 代码中使用生成的本地化类来访问翻译字符串。示例如下：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(S.of(context).helloWorld),
      ),
      body: Center(
        child: Text(S.of(context).helloWorld),
      ),
    );
  }
}

在这个示例中，我们通过 S.of(context) 来获取当前上下文的本地化字符串。

完整示例代码

下面是一个完整的示例代码，展示了如何配置和使用 intl_utils_plus 插件：

# pubspec.yaml
dependencies:
  intl_utils_plus: ^1.0.0

flutter_intl_plus:
  enabled: true
  class_name: S
  main_locale: zh
  arb_dir: lib/l10n
  output_dir: lib/generated
  use_deferred_loading: false

// lib/l10n/intl_zh.arb
{
  "@@locale": "zh",
  "helloWorld": "你好，世界！"
}

// lib/l10n/intl_en.arb
{
  "@@locale": "en",
  "helloWorld": "Hello, World!"
}

// lib/main.dart
import 'package:flutter/material.dart';
import 'package:intl_utils_plus/intl_utils_plus.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(S.of(context).helloWorld),
      ),
      body: Center(
        child: Text(S.of(context).helloWorld),
      ),
    );
  }
}