Flutter国际化插件very_easy_localization的使用

Flutter国际化插件very_easy_localization的使用

Very Easy Localization

Very Easy Localization 是一个命令行工具，用于从您的 Flutter 应用中提取字符串，并使用 Google 翻译创建超过100种语言的本地化。

安装

首先，通过以下命令安装 Very Easy Localization：

dart pub global activate very_easy_localization

基本使用

安装完成后，可以运行以下命令查看帮助信息：

dart pub global run very_easy_localization --help

基本选项

以下是可用的基本选项：

 -------------------------------------------------------------------
|                                                                   |
| -h, --help       Shows the help                                   |
| -v, --version    Prints the Very Easy Localization CLI Version    |
| run              Run the localization process                     |
|                                                                   |
 -------------------------------------------------------------------

生成

要生成本地化文件，运行以下命令：

dart pub global run very_easy_localization run

运行选项

以下是运行时的可用选项：

 --------------------------------------------------------------------------------
|                                                                                |
| -h, --help                    Shows the help                                   |
| -v, --version                 Prints the Very Easy Localization CLI Version    |
| -l, --languages               Pass the languages eg: en,ja,... [defaut: en,hi] |
| -i, --include-external-files  External Lib Files eg: ./assets/file.txt         |
| -o, --output-directory        Output Directory [default: ./ve_localization]    |
|                                                                                |
 --------------------------------------------------------------------------------

使用示例

下面是一个完整的示例，展示如何在 Flutter 应用中使用 Very Easy Localization 插件进行国际化。

1. 初始化项目

首先，确保你已经安装了 Flutter 和 Dart SDK。然后创建一个新的 Flutter 项目：

flutter create my_flutter_app
cd my_flutter_app

2. 添加依赖

在 pubspec.yaml 文件中添加 very_easy_localization 依赖：

dependencies:
  flutter:
    sdk: flutter
  very_easy_localization: ^1.0.0

然后运行以下命令以安装依赖：

flutter pub get

3. 生成本地化文件

使用 Very Easy Localization 工具生成本地化文件。假设你想生成英语（en）和日语（ja）的本地化文件：

dart pub global run very_easy_localization run -l en,ja

这将会在当前目录下创建 ./ve_localization 文件夹，并生成相应的 JSON 文件。

4. 配置应用

在 main.dart 文件中配置 Very Easy Localization：

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return VELocalization(
      path: './ve_localization', // 本地化文件路径
      initialLocale: Locale('en'), // 初始语言
      supportedLocales: [
        Locale('en'),
        Locale('ja')
      ],
      child: MaterialApp(
        title: 'Flutter Demo',
        theme: ThemeData(
          primarySwatch: Colors.blue,
        ),
        home: MyHomePage(),
      ),
    );
  }
}

5. 使用本地化文本

在你的 Flutter 小部件中使用本地化文本：

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

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(VeText('app_title')), // 使用本地化文本
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(VeText('welcome_message')), // 使用本地化文本
            TextButton(
              onPressed: () {
                // 切换语言
                VELocalization.of(context).setLocale(Locale('ja'));
              },
              child: Text(VeText('switch_language')),
            ),
          ],
        ),
      ),
    );
  }
}

6. 本地化文件

在 ./ve_localization 文件夹中，你会看到类似如下的 JSON 文件：

{
  "en": {
    "app_title": "My Flutter App",
    "welcome_message": "Welcome to my app!",
    "switch_language": "Switch Language"
  },
  "ja": {
    "app_title": "私の Flutter アプリ",
    "welcome_message": "アプリへようこそ！",
    "switch_language": "言語を切り替える"
  }
}