state_holder 是一个用于 Flutter 应用状态管理的插件，它允许你在应用的不同部分之间共享和持久化状态。使用 state_holder，你可以轻松地管理应用的状态，并在需要时将其持久化到本地存储中。

安装 state_holder

首先，你需要在 pubspec.yaml 文件中添加 state_holder 依赖：

dependencies:
  flutter:
    sdk: flutter
  state_holder: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

基本用法

1. 创建一个状态持有者

首先，你需要创建一个继承自 StateHolder 的类来管理你的状态。

import 'package:state_holder/state_holder.dart';

class CounterStateHolder extends StateHolder {
  int _count = 0;

  int get count => _count;

  void increment() {
    _count++;
    notifyListeners(); // 通知监听者状态已更新
  }

  [@override](/user/override)
  Map<String, dynamic> toJson() {
    return {'count': _count};
  }

  [@override](/user/override)
  void fromJson(Map<String, dynamic> json) {
    _count = json['count'] ?? 0;
  }
}

2. 在应用中使用状态持有者

你可以在应用的任何地方使用 StateHolderProvider 来提供状态持有者，并使用 StateHolderConsumer 来监听状态的变化。

import 'package:flutter/material.dart';
import 'package:state_holder/state_holder.dart';
import 'counter_state_holder.dart'; // 导入你创建的状态持有者

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return StateHolderProvider(
      stateHolder: CounterStateHolder(),
      child: MaterialApp(
        home: HomeScreen(),
      ),
    );
  }
}

class HomeScreen extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('State Holder Example'),
      ),
      body: Center(
        child: StateHolderConsumer<CounterStateHolder>(
          builder: (context, stateHolder) {
            return Text(
              'Count: ${stateHolder.count}',
              style: TextStyle(fontSize: 24),
            );
          },
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () {
          StateHolder.of<CounterStateHolder>(context).increment();
        },
        child: Icon(Icons.add),
      ),
    );
  }
}

3. 持久化状态

state_holder 提供了 StateHolderPersistence 类来帮助你将状态持久化到本地存储中。你可以在应用启动时加载状态，并在应用关闭时保存状态。

import 'package:flutter/material.dart';
import 'package:state_holder/state_holder.dart';
import 'counter_state_holder.dart';

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

  // 创建状态持有者
  final counterStateHolder = CounterStateHolder();

  // 从本地存储加载状态
  await StateHolderPersistence.load(counterStateHolder);

  runApp(MyApp(counterStateHolder: counterStateHolder));
}

class MyApp extends StatelessWidget {
  final CounterStateHolder counterStateHolder;

  MyApp({required this.counterStateHolder});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return StateHolderProvider(
      stateHolder: counterStateHolder,
      child: MaterialApp(
        home: HomeScreen(),
      ),
    );
  }
}

class HomeScreen extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('State Holder Example'),
      ),
      body: Center(
        child: StateHolderConsumer<CounterStateHolder>(
          builder: (context, stateHolder) {
            return Text(
              'Count: ${stateHolder.count}',
              style: TextStyle(fontSize: 24),
            );
          },
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () {
          StateHolder.of<CounterStateHolder>(context).increment();
        },
        child: Icon(Icons.add),
      ),
    );
  }
}

// 在应用关闭时保存状态
class MyAppState extends State<MyApp> {
  [@override](/user/override)
  void dispose() {
    StateHolderPersistence.save(widget.counterStateHolder);
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Container();
  }
}