Flutter国际化插件sheets_i18n的使用

当然，下面是一个关于如何使用Flutter国际化插件sheets_i18n的示例代码案例。这个插件可以帮助你轻松地在Flutter应用中实现国际化。

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  sheets_i18n: ^latest_version  # 请替换为最新版本号

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

2. 创建翻译文件

假设你要支持英语和中文，你需要创建两个翻译文件：messages_en.json和messages_zh.json。

messages_en.json

{
  "greeting": "Hello",
  "farewell": "Goodbye"
}

messages_zh.json

{
  "greeting": "你好",
  "farewell": "再见"
}

3. 配置sheets_i18n

在你的Flutter项目中创建一个新的Dart文件，比如i18n.dart，用于初始化sheets_i18n。

import 'package:flutter/material.dart';
import 'package:sheets_i18n/sheets_i18n.dart';

class I18n {
  static SheetsI18n? _sheetsI18n;

  static SheetsI18n get sheets => _sheetsI18n!;

  static Future<void> load(Locale locale) async {
    final String jsonPath = 'assets/messages_${locale.languageCode}.json';
    final SheetsI18n sheetsI18n = SheetsI18n.delegate(
      fallbackFile: 'assets/messages_en.json', // 默认语言文件
      jsonMap: await rootBundle.loadString(jsonPath),
    );
    _sheetsI18n = sheetsI18n;
  }
}

4. 加载翻译文件

在你的MaterialApp中，使用Localizations和SheetsI18nDelegate来加载翻译文件。

import 'package:flutter/material.dart';
import 'i18n.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      localizationsDelegates: [
        SheetsI18n.delegate(fallbackFile: 'assets/messages_en.json'),
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
      ],
      supportedLocales: [
        Locale('en', ''),
        Locale('zh', ''),
      ],
      locale: Locale('en'), // 默认语言
      onGenerateRoute: (RouteSettings settings) {
        // 在这里你可以根据路由加载不同的语言
        final Locale locale = settings.locale ?? Locale('en');
        return FutureBuilder<void>(
          future: I18n.load(locale),
          builder: (BuildContext context, AsyncSnapshot<void> snapshot) {
            if (snapshot.connectionState == ConnectionState.done) {
              // 加载完成后返回主页面
              if (settings.name == '/') {
                return MaterialPageRoute<void>(
                  builder: (BuildContext context) => HomePage(),
                );
              }
            }
            // 显示加载中页面或错误页面
            return MaterialPageRoute<void>(
              builder: (BuildContext context) => Scaffold(
                body: Center(child: CircularProgressIndicator()),
              ),
            );
          },
        );
      },
      home: HomePage(), // 初始页面
    );
  }
}

class HomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(I18n.sheets.translate('greeting')),
      ),
      body: Center(
        child: Text(I18n.sheets.translate('farewell')),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () {
          // 切换语言示例
          Navigator.push(
            context,
            MaterialPageRoute<void>(
              builder: (BuildContext context) => LanguageSwitcher(),
            ),
          );
        },
        tooltip: 'Increment',
        child: Icon(Icons.add),
      ),
    );
  }
}

class LanguageSwitcher extends StatefulWidget {
  @override
  _LanguageSwitcherState createState() => _LanguageSwitcherState();
}

class _LanguageSwitcherState extends State<LanguageSwitcher> {
  Locale? _currentLocale;

  @override
  Widget build(BuildContext context) {
    final Locale locale = Localizations.localeOf(context);
    _currentLocale ??= locale;

    return Scaffold(
      appBar: AppBar(
        title: Text('Language Switcher'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            TextButton(
              onPressed: () async {
                setState(() {
                  _currentLocale = Locale('en');
                });
                await I18n.load(_currentLocale!);
                Navigator.pop(context);
                Navigator.pushReplacement(
                  context,
                  MaterialPageRoute<void>(
                    builder: (BuildContext context) => MyApp(),
                  ),
                );
              },
              child: Text('English'),
            ),
            TextButton(
              onPressed: () async {
                setState(() {
                  _currentLocale = Locale('zh');
                });
                await I18n.load(_currentLocale!);
                Navigator.pop(context);
                Navigator.pushReplacement(
                  context,
                  MaterialPageRoute<void>(
                    builder: (BuildContext context) => MyApp(),
                  ),
                );
              },
              child: Text('中文'),
            ),
          ],
        ),
      ),
    );
  }
}

5. 确保资源文件被正确加载

在pubspec.yaml中确保你的翻译文件被包含为资源文件：

flutter:
  assets:
    - assets/messages_en.json
    - assets/messages_zh.json

总结

这个示例展示了如何使用sheets_i18n插件在Flutter应用中实现国际化。通过创建翻译文件、配置插件、加载翻译文件以及在应用中显示翻译文本，你可以轻松地为你的应用添加多语言支持。