القائمة
使用 fx_boot_starter 接入 App 启动流程。适用于需要闪屏页、初始化异步任务、启动状态管理的场景。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
使用 fx_dio 进行 Flutter HTTP 请求开发。基于实际项目实践的模式，包含 Host 定义、请求发起、返回值处理、异常追踪等核心流程。
使用 fx_event 进行类型化事件通信。适用于回调层级过深、跨模块通信、远距离组件交互、异步请求-响应等场景。
使用 fx_exception 构建统一异常追踪体系。提供 Code、Trace、TraceMixin 三个核心协议，各模块基于此扩展自定义异常。
使用 fx_trace 进行应用级异常/日志追踪。统一收集网络异常、业务提示、调试日志，支持级别过滤和 State 生命周期绑定。
| name | fx-boot-starter-usage |
| description | 使用 fx_boot_starter 接入 App 启动流程。适用于需要闪屏页、初始化异步任务、启动状态管理的场景。 |
| metadata | {"author":"toly","version":"0.2.0","tags":["fx","boot","starter","splash","init","flutter","app"]} |
fx_boot_starter: 0.2.0
检查项目是否包含 fx_boot_starter 依赖。
| 概念 | 说明 |
|---|---|
| AppStartRepository<S> | 启动数据仓库，实现 initApp() 返回配置 |
| AppStartAction<S> | 生命周期回调（onLoaded/onStartSuccess/onStartError） |
| FxStarter<T> | 应用入口 mixin，组合 Repository + Action + 全局异常捕获 |
| AppStartScope<S> | Widget tree 注入，提供 AppStartBloc |
| AppStartListener<S> | 监听状态变化，触发 Action 回调 |
| AppStatus | sealed class（Starting/LoadDone/Success/Failed） |
1. 定义配置类 → App 启动后需要的数据结构
2. 实现 Repository → initApp() 中执行初始化任务
3. 实现 Application → with FxStarter，实现回调
4. main 启动 → MyApplication().run()
5. UI 层监听 → AppStartListener 包裹闪屏页
#[[file:references/boot_starter.md]]
| API | 作用 |
|---|---|
MyApp().run() | 启动应用（FxStarter mixin） |
AppStartScope.of<S>(context) | 获取 AppStartBloc 实例 |
context.startApp<S>() | 手动触发启动 |
AppStartScope(minStartDurationMs: 800) | 自定义最小闪屏时间 |
const 构造initApp() 内自由组织初始化顺序Future.wait 并行onStartSuccess 中做页面跳转onStartError 中引导用户处理错误onGlobalError 中上报未捕获异常