intl_utils 使用指南

1. 项目介绍

intl_utils 是一个用于 Dart 和 Flutter 项目的国际化工具包。它能够从 ARB（Application Resource Bundle）文件中生成 Dart 本地化代码，简化了国际化和本地化工作流程。生成的代码依赖于 Dart 官方的 Intl 库，提供了自动完成功能，极大地提高了开发效率。

2. 项目快速启动

2.1 安装依赖

首先，在项目的 pubspec.yaml 文件中添加 intl_utils 依赖：

dependencies:
  flutter:
    sdk: flutter
  intl_utils: ^2.8.7

然后运行以下命令安装依赖：

flutter pub get

2.2 配置项目

在 pubspec.yaml 文件中添加 intl_utils 的配置：

flutter_intl:
  enabled: true
  class_name: S
  main_locale: en
  arb_dir: lib/l10n
  output_dir: lib/generated
  use_deferred_loading: false

2.3 添加 ARB 文件

在 lib/l10n 目录下为每种语言添加一个 ARB 文件，例如 intl_en.arb 和 intl_zh.arb。

2.4 生成本地化代码

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

flutter pub run intl_utils:generate

2.5 在应用中使用

在 MaterialApp 中配置本地化代理和受支持的语言：

import 'package:flutter/material.dart';
import 'generated/l10n.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      localizationsDelegates: [
        S.delegate,
      ],
      supportedLocales: S.delegate.supportedLocales,
      home: HomePage(),
    );
  }
}

class HomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(S.of(context).appTitle),
      ),
      body: Center(
        child: Text(S.of(context).welcomeMessage),
      ),
    );
  }
}

3. 应用案例和最佳实践

3.1 多语言支持

通过 intl_utils，你可以轻松地为你的 Flutter 应用添加多语言支持。只需在 ARB 文件中添加不同语言的翻译，然后运行生成命令即可。

3.2 自动完成

intl_utils 生成的代码支持自动完成功能，这使得在编写代码时可以快速找到并使用翻译键，减少了手动输入错误的可能性。

3.3 持续集成

你可以将 intl_utils 集成到持续集成（CI）工具中，确保每次代码提交时都能自动生成最新的本地化代码。

4. 典型生态项目

4.1 Flutter Intl 插件

Flutter Intl 是一个 Visual Studio Code 和 IntelliJ/Android Studio 的插件，它能够自动运行 intl_utils，并在你修改 ARB 文件时自动生成本地化代码。

4.2 Localizely 平台

Localizely 是一个在线的国际化管理平台，支持与 intl_utils 集成。你可以通过 Localizely 上传和下载 ARB 文件，管理翻译内容，并使用其 Over-the-air（OTA）功能实时更新应用的翻译。

通过这些工具和平台的结合使用，你可以更高效地管理和维护应用的国际化内容。