Flutter异步状态管理插件asyncstate的使用

Async State 是一个用于Flutter应用的状态管理插件，旨在简化异步操作中的加载器和异常处理。以下是该插件的基本用法和示例代码。

基本用法

1. 包裹你的MaterialApp或CupertinoApp：使用AsyncStateBuilder来包裹你的应用程序。
2. 获取并传递navigatorObserver：从AsyncStateBuilder的builder函数中获取navigatorObserver，并将其添加到你的组件的navigatorObservers列表中。
3. 自定义加载器和异常处理器：你可以自定义默认加载器、启用或禁用日志、以及设置特定路由的异常处理器。

示例代码

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

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

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

  @override
  Widget build(BuildContext context) {
    return AsyncStateBuilder(
      customLoader: const GlobalLoading(), // 自定义全局加载器
      enableLog: true, // 启用日志
      exceptionHandlers: {
        '_': GlobalExceptionHandler(), // 全局异常处理器
        '/Home/Detail': DetailExceptionHandler(), // 特定路由的异常处理器
      },
      builder: (navigatorObserver) => MaterialApp(
        themeMode: ThemeMode.dark,
        theme: ThemeData.dark(),
        navigatorObservers: [navigatorObserver],
        initialRoute: '/Home',
        routes: {
          '/Home': (context) => const HomePage(),
          '/Home/Detail': (context) => const DetailPage(),
          '/Home/Detail/SecondDetail': (context) => const SecondDetailPage(),
        },
      ),
    );
  }
}

异步调用扩展方法

使用asyncState扩展方法可以在异步调用中自动管理加载器的打开和关闭：

Future<void> loginSuccess() async {
  final result = await _functionSuccess().asyncLoader();
  debugPrint('Login Success result: $result');
}

Future<void> loadMorePersonalized() async {
  await _functionFailure().asyncLoader(
    customLoader: HomeCustomLoaderSnackbar(),
    loaderType: LoaderType.snackBar,
  );
}

控制加载器

可以使用AsyncLoaderHandler来手动控制加载器的开启和关闭：

Future<void> loginSuccessHandler() async {
  final handler = AsyncLoaderHandler.start();
  final result = await _functionSuccess().asyncLoader();
  debugPrint('Login Success result: $result');
  handler.close();
}

// 在视图中使用
ElevatedButton(
  onPressed: () async {
    context.startAsyncStateLoader();
    await errorCall();
    context.closeAsyncStateLoader();
  },
  child: const Text('Loader Error by context'),
),

异常处理器

可以通过实现AsyncStateExceptionHandler接口来处理特定路由的异常：

class DetailExceptionHandler implements AsyncStateExceptionHandler {
  @override
  void onException(
    Object exception,
    StackTrace stackTrace,
    BuildContext context,
  ) {
    switch (exception.runtimeType) {
      case DetailException:
        ScaffoldMessenger.of(context).showSnackBar(
          SnackBar(
            content: Text(
              exception.toString(),
            ),
          ),
        );
      default:
        log(exception.toString());
        break;
    }
  }
}

在主函数中配置特定路由的异常处理器：

exceptionHandlers: {
  '_': GlobalExceptionHandler(),
  '/Home/Detail': DetailExceptionHandler(),
},

总结

通过使用Async State插件，开发者可以更轻松地管理Flutter应用中的异步操作，包括加载器和异常处理。更多详细信息和贡献指南，请访问GitHub项目页面。

这个Markdown文档提供了关于如何使用Flutter异步状态管理插件`asyncstate`的详细说明和完整的示例代码。希望对你有所帮助！