Flutter性能优化插件SpeedEx的使用

SpeedEx，简称Speed Execution，是一个轻量且高效的Flutter状态管理解决方案。它旨在提高性能，提供了一种简单而强大的方式来管理应用中的全局状态，并且几乎没有样板代码。

特性

• 🚀 快速高效的状态管理
• 🌐 全局状态可从应用的任何地方访问
• 🧮 支持计算值
• 🔄 内置撤销功能
• 🔍 状态更改历史跟踪
• 🔒 持久化支持
• 🔗 中间件用于拦截状态更改
• 📦 简单的API，仅使用一个用于状态消费的小部件
• 📱 在Android、iOS、Web、Windows、macOS和Linux上可用

安装

将SpeedEx添加到你的pubspec.yaml文件或通过pub.dev安装：

dependencies:
  speedex: ^0.0.3

然后运行：

flutter pub get

使用

初始化SpeedEx

在使用SpeedEx之前，确保在main.dart中初始化它：

import 'package:speedex/speedex.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await SpeedEx.initialize();
  runApp(MyApp());
}

设置和获取值

你可以设置和获取值：

// 设置一个值
await SpeedEx.setValue('counter', 0);

// 获取一个值
int counter = SpeedEx.getValue<int>('counter') ?? 0;

使用SpeedExWidget

SpeedExWidget是消费UI状态的主要方式：

SpeedExWidget<int>(
  stateKey: 'counter',
  builder: (context, value) {
    return Text('Counter: ${value ?? 0}');
  },
  initialValue: 0,
  persist: true,
)

计算值

你可以设置计算值：

SpeedEx.setComputedValue<int>('doubleCounter', () {
  return (SpeedEx.getValue<int>('counter') ?? 0) * 2;
});

撤销功能

你可以撤销状态更改：

await SpeedEx.undo();

中间件

你可以添加中间件来拦截状态更改：

SpeedEx.addMiddleware((key, oldValue, newValue) async {
  print('State changed: $key, $oldValue -> $newValue');
});

完整示例

以下是一个完整的示例：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await SpeedEx.initialize();

  SpeedEx.addMiddleware((key, oldValue, newValue) async {
    print('State changed: $key, $oldValue -> $newValue');
  });

  await SpeedEx.setValue('counter', 0, persist: true);
  SpeedEx.setComputedValue<int>('doubleCounter', () {
    return (SpeedEx.getValue<int>('counter') ?? 0) * 2;
  });

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('SpeedEx Demo')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              SpeedExWidget<int>(
                stateKey: 'counter',
                builder: (context, value) {
                  return Text('Counter: ${value ?? 0}');
                },
              ),
              SpeedExWidget<int>(
                stateKey: 'doubleCounter',
                builder: (context, value) {
                  return Text('Double Counter: ${value ?? 0}');
                },
              ),
              ElevatedButton(
                onPressed: () async {
                  int currentValue = SpeedEx.getValue<int>('counter') ?? 0;
                  await SpeedEx.setValue('counter', currentValue + 1, persist: true);
                },
                child: Text('Increment'),
              ),
              ElevatedButton(
                onPressed: SpeedEx.undo,
                child: Text('Undo'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

文档

如需详细的文档，请访问SpeedEx Wiki。

问题

如果你发现了一个错误或者有功能请求，请访问我们的问题页面报告。

贡献

欢迎贡献！请随时提交Pull Request。对于问题和功能请求，请查看我们的问题页面。

许可证

该项目采用MIT许可证——详情请参阅LICENSE文件。关于MIT许可证的全面概述，你也可以在这里查看它。