Flutter简单设置管理插件simple_setting的使用

Flutter简单设置管理插件simple_setting的使用

simple_setting 是一个用于简化 Flutter 应用程序国际化（i18n）的包。

使用方法

要使用此插件，需要在 pubspec.yaml 文件中添加 simple_setting 作为依赖项。

dependencies:
  simple_setting: ^最新版本号

步骤0

导入包：

import 'package:simple_setting/simple_setting.dart';

步骤1

定义一个类来存储语言映射，例如：

class Lang {
  static const Map<String, String> vi = {
    "title": "Ví dụ",
  };

  static const Map<String, String> en = {
    "title": "Example",
  };
}

如果你使用 JSON 文件，可以跳过这一步。

步骤2

初始化语言信息，并将第一个小部件包装在 SettingProvider 中：

void main() {
  SimpleSetting.init(languageData: Lang.vi);
  runApp(const MyApp());
}

// 如果使用 JSON 文件
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  SimpleSetting.init(languageData: await "path to asset json file".js());
  runApp(const MyApp());
}

步骤3

通过 SettingWidget 捕获语言设置更改，并使用字符串扩展 obs 来使用语言：

SettingWidget(builder: (_, __, ___) {
  return MyHomePage(title: "title".obs());
}

// 或者使用 Text 小部件的扩展
Text("title").obs()

步骤4

当你想要更改语言时，使用以下语句：

SimpleSetting.changeLanguage(Lang.en);

// 对于 JSON 文件
SimpleSetting.changeLanguage(await "path to asset json file".js());

注意事项

• 如果你需要根据系统语言自动更改语言，可以在 init 函数中传递 langMap 参数，例如：

SimpleSetting.init(langMap: {
    "en_US": Lang.en,
    "vi_VN": Lang.vi
});

• 如果你需要格式化带参数的字符串，可以将参数传递给 obs 扩展：

class Lang {
  static const Map<String, String> vi = {
    "title": "Ví dụ :id",
  };

  static const Map<String, String> en = {
    "title": "Example :id",
  };
}

// 使用
Text("title".obs(params: {"id": 1}));

// 或者
Text("title").obs(params: {"id": 1});

完整示例

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

void main() {
  SimpleSetting.init(languageData: Lang.vi);
  runApp(const MyApp());
}

class Lang {
  static const Map<String, String> vi = {
    "title": "Ví dụ",
  };

  static const Map<String, String> en = {
    "title": "Example",
  };
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: "title",
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: "title"),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title).obs(),
      ),
      body: Container(),
      floatingActionButton: FloatingActionButton(
        onPressed: () {
          // 检查当前语言
          bool isVi = SettingData.lang == Lang.vi;
          SimpleSetting.changeLanguage(isVi ? Lang.en : Lang.vi);
        },
        tooltip: 'Increment',
        child: const Icon(Icons.add),
      ),
    );
  }
}