Flutter系统设置访问插件clever_settings_flutter的使用

安装 💻

在你的 pubspec.yaml 文件中添加 clever_settings_flutter 和 clever_settings：

dependencies: 
  clever_settings: ^[version]
  clever_settings_flutter: ^[version]

然后安装它们：

flutter packages get

初始化 🚀

在你开始使用 Clever Settings 之前，你需要先初始化它。调用一次 init 函数以启动你的应用程序：

await CleverSettingsFlutter.init();

这将初始化 Hive 并打开设置数据库。 如果你想要自行配置 Hive，可以在 Hive 初始化之后使用 CleverSettings.open()。

使用 💡

本部分仅关注 clever_settings_flutter 的附加功能。有关 clever_settings 基本用法的详细信息，请参阅 这里。

SettingsValueBuilder

SettingsValueBuilder 是一个用于构建依赖于 SettingsValue 对象的其他小部件的部件。当设置值更改时，它会重新构建。

示例：

class Settings {
  static const mySetting = SettingsValue<bool>(name: 'mySetting', defaultValue: true);
}

...

SettingsValueBuilder(
  setting: Settings.mySetting,
  builder: (context, value, child) {
    return Text(value.toString());
  },
),

MultiSettingsValueBuilder

MultiSettingsValueBuilder 是一个允许你监听并组合多个 SettingsValue 对象的小部件，以构建依赖于所有这些对象的小部件。

示例：

class Settings {
  static final mySetting = DefaultSettingsValue<bool>(name: 'mySetting', defaultValue: true);
  static final myOtherSetting = DefaultSettingsValue<bool>(name: 'myOtherSetting', defaultValue: false);
}

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Clever Settings')),
      body: Column(
        children: [
          MultiSettingsValueBuilder(
            settings: [
              Settings.mySetting,
              Settings.myOtherSetting,
            ],
            builder: (context, values) {
              // 当其中一个设置更改时更新。
              return Text('${values[0].value} ${values[1].value}');
            },
          ),
          FilledButton(
            onPressed: () {
              Settings.mySetting.value = !Settings.mySetting.value;
            },
            child: const Text('Change setting'),
          ),
        ],
      ),
    );
  }
}

示例代码

以下是完整的示例代码，展示了如何使用 clever_settings_flutter 插件。

import 'package:clever_settings/clever_settings.dart';
import 'package:clever_settings_flutter/clever_settings_flutter.dart';
import 'package:flutter/material.dart';

Future<void> main(List<String> args) async {
  await CleverSettingsFlutter.init();
  runApp(const App());
}

class App extends StatelessWidget {
  const App({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(useMaterial3: true),
      home: const HomePage(),
    );
  }
}

class Settings {
  static final mySetting = DefaultSettingsValue<bool>(name: 'mySetting', defaultValue: true);
}

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Clever Settings')),
      body: Column(
        children: [
          SettingsValueBuilder(
            setting: Settings.mySetting,
            builder: (context, value, child) {
              return Text(value.toString());
            },
          ),
          MultiSettingsValueBuilder(
            settings: [
              Settings.mySetting,
            ],
            builder: (context, values) {
              return Text(values[0].value.toString());
            },
          ),
          FilledButton(
            onPressed: () {
              Settings.mySetting.value = !Settings.mySetting.value;
            },
            child: const Text('Change setting'),
          ),
        ],
      ),
    );
  }
}