Flutter国际化插件 gettext 的使用

在Flutter项目中实现国际化，可以使用 dart_gettext 插件。它是一个Dart实现的 gettext 框架，支持多语言、上下文、复数形式等特性，并且与Flutter兼容。

特性

• 支持域（domains）、上下文（contexts）和复数形式（plurals）
• 内置了136种语言的复数形式
• 可以动态更改语言或域
• 对于内部错误（如缺少翻译），会发出事件

使用方法

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  gettext: ^0.1.0
  flutter_gettext: ^0.1.0

然后运行 flutter pub get 来安装这些包。

2. 加载翻译文件

JSON 文件加载示例

假设你有一个JSON格式的翻译文件 en_US.json，内容如下：

{
  "charset": "utf-8",
  "headers": {
    "mime-version": "1.0",
    "content-type": "text/plain; charset=utf-8",
    "content-transfer-encoding": "8bit",
    "language": "es-ES",
    "plural-forms": "nplurals=2; plural=(n!=1);"
  },
  "translations": {
    "": {
      "Hello": {
        "msgid": "Hello",
        "comments": {
           "translator": "Normal string"
        },
        "msgstr": [
           "Hola"
        ]
      },
      "An apple": {
        "msgid": "1 apple",
        "comments": {
           "translator": "Plural string"
        },
        "msgstr": [
           "una manzana",
           "%d manzanas"
        ]
      }
    }
  }
}

你可以通过以下代码加载这个文件：

import 'dart:convert';
import 'dart:io';
import 'package:gettext/gettext.dart';

void main() async {
  final data = await File("./en_US.json").readAsString();

  final gt = Gettext();
  gt.addLocale(json.decode(data));

  print(gt.gettext("Hello")); // 输出：Hola
  print(gt.ngettext("An apple", "%d apples", 1)); // 输出：una manzana
  print(gt.ngettext("An apple", "%d apples", 3)); // 输出：3 manzanas
}

.mo 或 .po 文件加载示例

如果你有 .mo 或 .po 格式的翻译文件，可以使用 gettext_parser 包来解析它们：

import 'package:gettext/gettext.dart';
import 'package:gettext_parser/gettext_parser.dart' as gettextParser;

void loadTranslations() async {
  final data = await File("./en_US.mo").readAsString();

  final gt = Gettext();
  gt.addLocale(gettextParser.mo.parse(data));
}

3. 在Flutter应用中使用

为了在Flutter应用中使用 gettext，你需要使用 flutter_gettext 包。下面是一个完整的Flutter示例：

import 'package:flutter/material.dart';
import 'package:gettext/gettext.dart';
import 'dart:convert';
import 'dart:io';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 加载翻译文件
  final data = await File("./en_US.json").readAsString();
  final gt = Gettext();
  gt.addLocale(json.decode(data));

  runApp(MyApp(gt: gt));
}

class MyApp extends StatelessWidget {
  final Gettext gt;

  MyApp({required this.gt});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(gt: gt),
    );
  }
}

class MyHomePage extends StatelessWidget {
  final Gettext gt;

  MyHomePage({required this.gt});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter Gettext Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(gt.gettext("Hello")),
            Text(gt.ngettext("An apple", "%d apples", 1)),
            Text(gt.ngettext("An apple", "%d apples", 3)),
          ],
        ),
      ),
    );
  }
}

4. 更改语言和域

你可以随时更改当前的语言环境或域：

// 更改语言
gt.locale = "es_ES";

// 更改默认域
gt.domain = "types";

5. API

以下是 gettext 提供的主要API：

• addLocale(Map<String, dynamic> locale, {String domain: 'messages'})
• addTranslations(String localeName, Map<String, dynamic> translations, {String domain: 'messages'})
• setCatalog(String localeName, Catalog catalog)
• gettext(String msgid, {String domain, String context}) → String
• ngettext(String msgid, String msgplural, int count, {String domain, String context}) → String

以上就是关于如何在Flutter应用中使用 gettext 插件进行国际化的完整指南。希望对你有所帮助！