Flutter国际化插件gettext_i18n的使用

概述

gettext_i18n 是一个帮助Flutter应用程序实现国际化的包。它基于 gettext 和 gettext_parser。

功能特性

• 支持消息键中的占位符

使用方法

依赖安装

在 pubspec.yaml 文件中添加 gettext_i18n 和 flutter_localizations：

flutter pub add gettext_i18n
flutter pub add flutter_localizations --sdk=flutter

资源文件配置

在 pubspec.yaml 中，添加 assets/i18n/ 作为资源文件夹路径：

flutter:
  assets:
    - assets/i18n/

可选地，在该文件夹内放置您的翻译文件（例如：en.po, fr_CH.po, fr.po）。

初始化应用

在主应用文件中声明支持的语言环境，并初始化翻译：

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: const HomePage(),
      supportedLocales: const [
        Locale('en'),
        Locale('fr'),
        Locale('fr', 'CH'),
      ],
      localizationsDelegates: [
        GettextLocalizationsDelegate(defaultLanguage: 'en'),
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
      ],
      localeListResolutionCallback: (locales, supportedLocales) {
        if (locales != null) {
          for (var locale in locales) {
            var supportedLocale = supportedLocales.where((element) =>
                element.languageCode == locale.languageCode &&
                element.countryCode == locale.countryCode);
            if (supportedLocale.isNotEmpty) {
              return supportedLocale.first;
            }
            supportedLocale = supportedLocales.where(
                (element) => element.languageCode == locale.languageCode);
            if (supportedLocale.isNotEmpty) {
              return supportedLocale.first;
            }
          }
        }
        return null;
      },
    );
  }
}

翻译字符串

在需要进行翻译的文件中导入 gettext_i18n 包并使用上下文来获取翻译后的字符串：

import 'package:gettext_i18n/gettext_i18n.dart';

// 示例：带参数的翻译字符串
var translatedString = context.t('{2} ! Pi is greater than {0} and smaller than {1}', args: [3, 4, 'Hello']);

// 或者简单地翻译一个字符串
Text(context.t('Hello, world !')),

额外信息

.po 文件可以手动编辑，但建议使用专业的编辑器或在线服务来管理这些文件，以确保格式正确且易于维护。

完整示例代码

以下是包含上述所有步骤的一个完整示例代码：

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

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: const HomePage(),
      supportedLocales: ['en', 'fr', 'fr_CH'].map((l) => Locale(l)),
      localizationsDelegates: [
        GettextLocalizationsDelegate(defaultLanguage: 'en'),
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
      ],
      localeListResolutionCallback: (locales, supportedLocales) {
        if (locales != null) {
          for (var locale in locales) {
            var supportedLocale = supportedLocales.where((element) =>
                element.languageCode == locale.languageCode &&
                element.countryCode == locale.countryCode);
            if (supportedLocale.isNotEmpty) {
              return supportedLocale.first;
            }
            supportedLocale = supportedLocales.where(
                (element) => element.languageCode == locale.languageCode);
            if (supportedLocale.isNotEmpty) {
              return supportedLocale.first;
            }
          }
        }
        return null;
      },
    );
  }
}

class HomePage extends StatelessWidget {
  const HomePage({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Center(
      child: Text(context.t('Hello, world !')),
    );
  }
}

通过以上步骤，您可以在Flutter项目中成功实现多语言支持。希望这对您有所帮助！