Flutter数据获取插件translaty_fetcher的使用

在Flutter开发中，有时我们需要从远程服务器或本地文件中获取多语言翻译数据。translaty_fetcher 是一个专门用于处理这种需求的插件，它可以帮助我们轻松地获取单个语言或所有语言的翻译数据。

Features

• Fetch translations for one language（获取单个语言的翻译）
• Fetch translations for all languages（获取所有语言的翻译）

Additional information

请注意，translaty_fetcher 并不能直接使用，它只是 translaty 插件的一个辅助工具。如果你想了解更多关于 translaty 的信息，请访问 pub.dev。

使用示例

以下是一个完整的示例，展示如何使用 translaty_fetcher 获取翻译数据。

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 translaty 和 translaty_fetcher 依赖：

dependencies:
  translaty: ^0.1.0
  translaty_fetcher: ^0.1.0

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

2. 创建翻译文件

假设我们有一个包含翻译数据的 JSON 文件 translations.json，内容如下：

{
  "en": {
    "hello": "Hello",
    "welcome": "Welcome"
  },
  "zh": {
    "hello": "你好",
    "welcome": "欢迎"
  }
}

将此文件保存到项目的 assets 目录下，并在 pubspec.yaml 中声明资产文件：

flutter:
  assets:
    - assets/translations.json

再次运行 flutter pub get 以确保资产文件被正确加载。

3. 编写代码

接下来，编写代码来使用 translaty_fetcher 获取翻译数据：

import 'package:flutter/material.dart';
import 'package:translaty/translaty.dart';
import 'package:translaty_fetcher/translaty_fetcher.dart';

void main() async {
  // 初始化 Translaty
  await Translaty.init(
    fetcher: JsonFileFetcher('assets/translations.json'),
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: TranslationPage(),
    );
  }
}

class TranslationPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Translation Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            // 获取单个语言的翻译
            Text(Translaty.of(context).translate('hello', languageCode: 'en')),
            Text(Translaty.of(context).translate('welcome', languageCode: 'zh')),

            // 获取所有语言的翻译
            FutureBuilder<Map<String, dynamic>>(
              future: Translaty.of(context).fetchTranslations(),
              builder: (context, snapshot) {
                if (snapshot.connectionState == ConnectionState.waiting) {
                  return CircularProgressIndicator();
                } else if (snapshot.hasError) {
                  return Text('Error: ${snapshot.error}');
                } else {
                  final translations = snapshot.data!;
                  return Column(
                    children: translations.entries.map((entry) {
                      final languageCode = entry.key;
                      final translation = entry.value;
                      return Column(
                        crossAxisAlignment: CrossAxisAlignment.start,
                        children: [
                          Text('Language: $languageCode'),
                          Text('Translation: $translation'),
                        ],
                      );
                    }).toList(),
                  );
                }
              },
            ),
          ],
        ),
      ),
    );
  }
}

代码说明

1. 初始化 Translaty：

   await Translaty.init(
     fetcher: JsonFileFetcher('assets/translations.json'),
   );
   

   使用 JsonFileFetcher 从指定的 JSON 文件中加载翻译数据。

2. 获取单个语言的翻译：

   Text(Translaty.of(context).translate('hello', languageCode: 'en')),
   Text(Translaty.of(context).translate('welcome', languageCode: 'zh')),
   

   调用 translate 方法获取特定语言的翻译。

3. 获取所有语言的翻译：

   FutureBuilder<Map<String, dynamic>>(
     future: Translaty.of(context).fetchTranslations(),
     builder: (context, snapshot) { ... }
   )