Flutter国际化资源合并插件merge_arb的使用

Flutter国际化资源合并插件merge_arb的使用

特性

通过此代码生成器，您可以将多个ARB文件合并为一个单一的ARB文件。这使得在Flutter应用中进行字符串本地化时可以将字符串资源拆分为多个文件。

开始使用

首先，您需要在项目中添加merge_arb和build_runner作为开发依赖项。打开终端并运行以下命令：

flutter pub add --dev merge_arb build_runner

使用方法

接下来，您需要创建ARB文件，并将其放置在lib/l10n目录下。例如，您可以创建以下文件：

• lib/l10n/en.arb
• lib/l10n/id.arb
• 等等。

下面是一个具体的示例，展示如何创建和使用这些ARB文件。

示例代码

首先，创建两个ARB文件：en.arb和id.arb。

en.arb

{
  "@@locale": "en",
  "welcomeMessage": "Welcome to our app!",
  "goodbyeMessage": "Goodbye!"
}

id.arb

{
  "@@locale": "id",
  "welcomeMessage": "Selamat datang di aplikasi kami!",
  "goodbyeMessage": "Sampai jumpa!"
}

接下来，使用merge_arb插件来合并这些文件。在项目的根目录下运行以下命令：

flutter pub run merge_arb:merge_arb --input=lib/l10n --output=lib/generated/localizations.dart

该命令将读取lib/l10n目录下的所有ARB文件，并生成一个名为localizations.dart的文件，该文件包含了合并后的本地化字符串。

生成的localizations.dart文件

// lib/generated/localizations.dart

import 'package:flutter/material.dart';

class AppLocalizations {
  static Future<AppLocalizations> load(Locale locale) async {
    final String name = locale.countryCode == null ? locale.languageCode : locale.toString();
    final String localeName = Intl.canonicalizedLocale(name);

    return initializeMessages(localeName).then((_) {
      Intl.defaultLocale = localeName;
      return AppLocalizations();
    });
  }

  static AppLocalizations of(BuildContext context) {
    return Localizations.of<AppLocalizations>(context, AppLocalizations);
  }

  String get welcomeMessage {
    return Intl.message(
      'Welcome to our app!',
      name: 'welcomeMessage',
      desc: 'The welcome message shown on the app',
      args: [],
    );
  }

  String get goodbyeMessage {
    return Intl.message(
      'Goodbye!',
      name: 'goodbyeMessage',
      desc: 'The goodbye message shown on the app',
      args: [],
    );
  }
}

现在，您可以在应用中使用这些本地化字符串了。例如，在一个StatefulWidget中使用：

import 'package:flutter/material.dart';
import 'package:your_project_name/generated/localizations.dart';

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      localizationsDelegates: [
        AppLocalizations.delegate,
      ],
      supportedLocales: [
        Locale('en', ''),
        Locale('id', ''),
      ],
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    var localizations = AppLocalizations.of(context);

    return Scaffold(
      appBar: AppBar(
        title: Text(localizations.welcomeMessage),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(localizations.welcomeMessage),
            Text(localizations.goodbyeMessage),
          ],
        ),
      ),
    );
  }
}