csv_localizations_lego #

安装 #

1. 在项目的根目录打开终端，输入以下命令以安装 CLI 工具。如果还没有创建一个 Lego 项目，可以同时创建一个新的项目。

flutter pub global activate lego_cli
lego create

1. 在终端中，输入以下命令将 `csv_localizations_lego` 添加到项目中。

lego add csv_localizations_lego

使用说明 #

步骤 1: 创建 CSV 文件

首先，我们需要创建一个包含本地化数据的 CSV 文件。例如，我们可以创建一个名为 localization.csv 的文件，并将其放在 assets 文件夹中。

locale,key,value
en_US,app_title,My App
zh_CN,app_title,我的应用
en_US,greeting,Hello
zh_CN,greeting,你好

步骤 2: 配置 pubspec.yaml

确保在 pubspec.yaml 文件中添加了 csv_localizations_lego 和 path_provider 依赖项，并且将 CSV 文件添加为资产。

dependencies:
  csv_localizations_lego: ^1.0.0
  path_provider: ^2.0.9

flutter:
  assets:
    - assets/localization.csv

然后运行以下命令以更新依赖项：

flutter pub get

步骤 3: 初始化本地化服务

在应用程序的入口点（如 main.dart）中初始化本地化服务。

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

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

  // 初始化本地化服务
  await CsvLocalizationsLego.initialize(
    localeFilePath: 'assets/localization.csv',
    defaultLocale: 'en_US', // 默认语言
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Localizations Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

步骤 4: 使用本地化文本

在应用程序中使用本地化文本时，可以通过 CsvLocalizations.of(context) 来获取本地化字符串。

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(CsvLocalizations.of(context).getString('app_title')),
      ),
      body: Center(
        child: Text(CsvLocalizations.of(context).getString('greeting')),
      ),
    );
  }
}

步骤 5: 切换语言

要切换语言，可以调用 CsvLocalizations.setLocale() 方法并传入新的语言代码。

CsvLocalizations.setLocale(context, 'zh_CN');

完整示例代码

完整的示例代码如下：

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

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

  // 初始化本地化服务
  await CsvLocalizationsLego.initialize(
    localeFilePath: 'assets/localization.csv',
    defaultLocale: 'en_US', // 默认语言
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Localizations Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(CsvLocalizations.of(context).getString('app_title')),
      ),
      body: Center(
        child: Text(CsvLocalizations.of(context).getString('greeting')),
      ),
    );
  }
}