Flutter国际化插件easy_localization_csv_module的使用

插件简介

easy_localization_csv_module 是一个用于通过 CSV 文件设置 easy_localization 的模块。它可以帮助开发者快速实现 Flutter 应用的国际化功能。

安装步骤

以下是安装该插件的具体步骤：

1. 创建 JuneFlow 项目（如果尚未创建）

如果您的项目还没有使用 JuneFlow，请先创建一个 JuneFlow 项目。您可以参考以下指南： JuneFlow 创建指南。

2. 在项目根目录运行命令

在终端中进入您的 JuneFlow 项目根目录，执行以下命令以添加插件：

june add easy_localization_csv_module

使用方法

1. 准备 CSV 文件

首先，您需要准备一个 CSV 文件来存储不同语言的翻译内容。例如，我们创建一个名为 translations.csv 的文件，内容如下：

locale_key,en,zh
hello_world,Hello World,你好，世界
greeting,Greetings,Greetings

2. 初始化插件

在 main.dart 文件中初始化 easy_localization 和 easy_localization_csv_module：

import 'package:flutter/material.dart';
import 'package:easy_localization/easy_localization.dart';
import 'package:easy_localization_csv_module/easy_localization_csv_module.dart';

void main() async {
  // 初始化 JuneFlow
  await juneInit();

  // 设置 CSV 文件路径
  EasyLocalizationCsvModule.setCsvPath('assets/translations.csv');

  // 启动应用
  runApp(
    EasyLocalization(
      path: 'assets/translations.csv', // CSV 文件路径
      supportedLocales: [Locale('en'), Locale('zh')], // 支持的语言
      fallbackLocale: Locale('en'), // 默认语言
      child: MyApp(),
    ),
  );
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      localizationsDelegates: [
        EasyLocalization.of(context).delegate,
      ],
      supportedLocales: EasyLocalization.of(context).supportedLocales,
      home: HomePage(),
    );
  }
}

3. 在应用中使用翻译

在需要翻译的地方，使用 tr() 方法调用翻译内容。例如：

Text(tr('hello_world'))

4. 更改语言

可以通过调用 context.setLocale() 来切换语言。例如：

onPressed: () {
  context.setLocale(Locale('zh')); // 切换到中文
},

完整示例代码

以下是完整的示例代码：

import 'package:flutter/material.dart';
import 'package:easy_localization/easy_localization.dart';
import 'package:easy_localization_csv_module/easy_localization_csv_module.dart';

void main() async {
  // 初始化 JuneFlow
  await juneInit();

  // 设置 CSV 文件路径
  EasyLocalizationCsvModule.setCsvPath('assets/translations.csv');

  // 启动应用
  runApp(
    EasyLocalization(
      path: 'assets/translations.csv', // CSV 文件路径
      supportedLocales: [Locale('en'), Locale('zh')], // 支持的语言
      fallbackLocale: Locale('en'), // 默认语言
      child: MyApp(),
    ),
  );
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      localizationsDelegates: [
        EasyLocalization.of(context).delegate,
      ],
      supportedLocales: EasyLocalization.of(context).supportedLocales,
      home: HomePage(),
    );
  }
}

class HomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('HomePage'.tr()),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text(tr('hello_world')), // 显示 "Hello World" 或 "你好，世界"
            ElevatedButton(
              onPressed: () {
                context.setLocale(Locale('zh')); // 切换到中文
              },
              child: Text('Switch to Chinese'),
            ),
            ElevatedButton(
              onPressed: () {
                context.setLocale(Locale('en')); // 切换到英文
              },
              child: Text('Switch to English'),
            ),
          ],
        ),
      ),
    );
  }
}