Menu
使用 fx_boot_starter 接入 App 启动流程。适用于需要闪屏页、初始化异步任务、启动状态管理的场景。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional 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 中上报未捕获异常