Flutter功能管理插件sura_manager的使用

Flutter功能管理插件sura_manager的使用

Sura Manager 是一个用于处理异步值的插件。它类似于 ValueNotifier 和 ValueListenableBuilder，但专为异步值设计。以下是关于如何使用 sura_manager 插件的详细指南。

安装

在 pubspec.yaml 文件中添加以下依赖：

dependencies:
  sura_manager: ^1.5.0

使用场景和动机

假设你需要从API获取数据或使用返回UI变化的 Future 函数。传统方法可以使用 setState 或 FutureBuilder 来处理这种情况，但它们会创建大量样板代码，并缺乏一些功能，如刷新、事件回调等。

FutureManager 提供了一个解决方案，主要关注 Future 值的三种状态：加载、错误 和 完成。你可以使用 FutureManagerBuilder 来处理这些状态。

短示例

// 创建一个管理器
FutureManager<int> dataManager = FutureManager();

// 定义一个 Future 函数
dataManager.asyncOperation(() => doingSomeAsyncWorkAndReturnValueAsInt());

// 处理值
[@override](/user/override)
Widget(BuildContext context){
  return FutureManagerBuilder<int>(
      futureManager: dataManager,
      error: (error) => YourErrorWidget(error), // 可选
      loading: YourLoadingWidget(), // 可选
      ready: (context, data){
        return ElevatedButton(
          child: Text("My data: ${data}"),
          onPressed: (){
            dataManager.refresh(); // 刷新数据
          },
        );
      }
  );
}

FutureManager 类

FutureManager 类提供了多种属性、字段和方法来管理和操作异步值。

属性

属性 描述 默认值
futureFunction 需要运行并返回数据的函数 null
reloading 在调用 refresh 或 asyncOperation 时是否重置状态到加载 true
onSuccess 操作成功后的回调函数 null
onDone 操作完全完成后（类似于 try-catch 中的 finally）的回调函数 null
onError 操作出错后的回调函数 null

字段

字段 描述
data 当前管理器中的数据
error 管理器中的错误
hasData 检查管理器是否有数据
hasError 检查管理器是否有错误
future 当前 futureFunction 的未来对象
isRefreshing 检查管理器是否正在刷新

方法

方法 描述
when 类似于 FutureManagerBuilder 的方法
asyncOperation 运行将返回数据到管理器的 futureFunction
refresh 再次调用 asyncOperation。必须从构造函数赋值 futureFunction 或调用 asyncOperation 一次才能运行此方法，否则会记录错误
updateData 更新管理器中的数据的方法
modifyData 使用数据回调更新管理器中的数据的方法
resetData 重置一切到加载或空状态
addError 将错误添加到管理器中
clearError 清除管理器中的错误，仅在视图状态不是错误状态时有效

FutureManagerBuilder 类

FutureManagerBuilder 是一个方便的构建器，用于根据 FutureManager 的状态构建不同的小部件。

示例

class _HomePageState extends State<NewPage> {

  FutureManager<int> dataManager = FutureManager();

  [@override](/user/override)
  void initState() {
    dataManager.asyncOperation(()async{
      await Future.delayed(Duration(seconds: 2));
      // 向数据管理器添加 10
      return 10;
    });
    super.initState();
  }

  [@override](/user/override)
  void dispose() {
    dataManager.dispose();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    // 使用 FutureManagerBuilder
    return Scaffold(
      appBar: AppBar(
        actions: [
          IconButton(
            icon:Icon(Icons.refresh),
            onPressed:(){
              // 再次调用我们的 asyncOperation
              dataManager.refresh();
            },
          )
        ]
      ),
      body: FutureManagerBuilder<int>(
        futureManager: dataManager,
        error: (error) => YourErrorWidget(),
        loading: YourLoadingWidget(),
        ready: (context, data){
          // 结果: My data: 10
          return Text("My data: ${data}");
        }
      ),
    );
  }
}

更多关于Flutter功能管理插件sura_manager的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter功能管理插件sura_manager的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，以下是一个关于如何在Flutter项目中使用sura_manager插件进行功能管理的代码示例。sura_manager是一个假定的插件名称，用于说明如何在Flutter中实现功能管理。请注意，实际插件的功能和API可能会有所不同，这里提供的是一个概念性的示例。

首先，确保你已经在pubspec.yaml文件中添加了sura_manager依赖：

dependencies:
  flutter:
    sdk: flutter
  sura_manager: ^latest_version  # 替换为实际版本号

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

接下来，在你的Flutter项目中，你可以按照以下步骤使用sura_manager插件：

  1. 初始化插件：

    在你的main.dart文件中，或者任何合适的位置初始化sura_manager插件。

import 'package:flutter/material.dart';
import 'package:sura_manager/sura_manager.dart';  // 假设插件的导入路径是这样的

void main() {
  // 初始化插件（如果有初始化方法的话）
  SuraManager.instance.init();

  runApp(MyApp());
}

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

  1. 使用功能管理：

    假设sura_manager插件提供了管理功能开启/关闭的方法，你可以在需要的地方调用这些方法。

import 'package:flutter/material.dart';
import 'package:sura_manager/sura_manager.dart';  // 插件导入

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  bool _isFeatureEnabled = false;

  @override
  void initState() {
    super.initState();

    // 检查功能是否启用（假设插件提供了这样的方法）
    SuraManager.instance.isFeatureEnabled('some_feature_flag').then((isEnabled) {
      setState(() {
        _isFeatureEnabled = isEnabled;
      });
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Feature Management Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              'Feature is $_isFeatureEnabled',
              style: TextStyle(fontSize: 24),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                // 切换功能状态（假设插件提供了这样的方法）
                SuraManager.instance.toggleFeature('some_feature_flag').then((newState) {
                  setState(() {
                    _isFeatureEnabled = newState;
                  });
                });
              },
              child: Text('Toggle Feature'),
            ),
          ],
        ),
      ),
    );
  }
}

在这个示例中，我们假设sura_manager插件提供了isFeatureEnabled和toggleFeature方法，用于检查和切换某个功能的启用状态。当然，实际插件的API可能会有所不同，你需要参考插件的官方文档来调整代码。

请注意，由于sura_manager是一个假定的插件名称，上面的代码是基于假设的API编写的。在实际使用中，你需要根据插件提供的实际API进行调整。如果sura_manager插件不存在或者API与假设不同，你可能需要寻找或创建一个符合你需求的功能管理插件。

回到顶部