Flutter启动配置插件fx_boot_starter的使用

Flutter启动配置插件fx_boot_starter的使用

在Flutter应用开发过程中，我们经常需要处理一些启动时的异步任务，例如数据加载、网络请求等。fx_boot_starter 插件可以帮助我们更方便地管理这些启动任务，并且能够处理启动过程中的错误。

逻辑实现

通过实现 AppStartRepository 接口来处理应用启动时的异步任务，并在 initApp 函数中返回初始化后的 AppState。同时，通过 fixError 方法来处理启动过程中出现的错误。

class AppStartRepositoryImpl implements AppStartRepository<AppState> {
  const AppStartRepositoryImpl();

  [@override](/user/override)
  Future<AppState> initApp() async {
    /// 可以处理异步加载任务
    /// 返回初始化的 AppState
    await Future.delayed(const Duration(seconds: 1));
    if (_isErrorDebug) {
      // throw "App 初始化异常";
    }
    return AppState(0);
  }

  [@override](/user/override)
  Future<void> fixError(Object error, {Object? extra}) async {
    await Future.delayed(const Duration(seconds: 1));
    // throw "App 无法修复";
    _isErrorDebug = false;
    return;
  }
}

监听启动动作

通过实现 AppStartAction 接口来监听应用启动状态的变化。包括启动成功、启动失败以及启动耗时等信息。

class AppStartActionImpl implements AppStartAction<AppState> {
  const AppStartActionImpl();

  [@override](/user/override)
  void onLoaded(BuildContext context, int cost, AppState state) {
    debugPrint("App启动耗时:$cost ms");
  }

  [@override](/user/override)
  void onStartError(BuildContext context, Object error, StackTrace trace) {
    // TODO 处理启动失败
  }

  [@override](/user/override)
  void onStartSuccess(BuildContext context, AppState state) {
    // TODO 处理启动成功
  }
}

完整示例代码

以下是一个完整的示例代码，展示了如何使用 fx_boot_starter 插件来管理应用的启动任务。

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

import 'starter/data/app_state.dart'; // 引入AppState类
import 'starter/impl/app_fix_action.dart'; // 引入AppFixAction类
import 'starter/impl/app_start_action.dart'; // 引入AppStartAction类
import 'starter/impl/start_repository.dart'; // 引入AppStartRepositoryImpl类
import 'starter/views/splash_page.dart'; // 引入SplashPage页面

void main() {
  runApp(
    const AppStartScope<AppState>(
      repository: AppStartRepositoryImpl(), // 注册启动仓库
      appStartAction: AppStartActionImpl(), // 注册启动动作
      child: MyApp(),
    ),
  );
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
        debugShowCheckedModeBanner: false,
        title: 'Flutter Demo',
        theme: ThemeData(
          colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
          useMaterial3: true,
        ),
        home: const AppStartListener<AppState>(
          child: SplashPage(), // 启动页
        ));
  }
}