메뉴
使用 fx_trace 进行应用级异常/日志追踪。统一收集网络异常、业务提示、调试日志，支持级别过滤和 State 生命周期绑定。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | fx-trace-usage |
| description | 使用 fx_trace 进行应用级异常/日志追踪。统一收集网络异常、业务提示、调试日志，支持级别过滤和 State 生命周期绑定。 |
| metadata | {"author":"toly","version":"0.1.0","tags":["fx","trace","log","exception","error","flutter"]} |
fx_trace: 0.1.0 | fx_exception: 0.0.1+2
检查项目是否包含 fx_trace 依赖。
| 概念 | 说明 |
|---|---|
| Trace | 异常/日志协议 mixin（来自 fx_exception） |
| FxTrace | 全局追踪分发单例 |
| LogTrace | 日志追踪，支持级别过滤 |
| TipTrace | 提示追踪（info/warning/error/success） |
| CatchTrace | 捕获的异常包装 |
| TraceStateMixin | 在 State 中自动监听 Trace |
1. 注册监听 → FxTrace().addTraceListener(...)
2. 发送 Trace → trace.emit()
3. 设置级别 → FxTrace.minLogLevel = LogLevel.xxx
4. 桥接 fx_dio（可选） → 网络异常统一收集
注册全局 listener 或使用 State mixin。
#[[file:references/listen.md]]
使用 LogTrace / TipTrace / CatchTrace 或自定义 Trace。
#[[file:references/emit_trace.md]]
通过 minLogLevel 控制 LogTrace 的过滤阈值。
#[[file:references/log_level.md]]
将 fx_dio 的网络异常统一收入 FxTrace。
#[[file:references/bridge_dio.md]]
| API | 作用 |
|---|---|
FxTrace().addTraceListener(callback) | 注册监听 |
FxTrace().removeTraceListener(callback) | 移除监听 |
FxTrace().emit(trace) | 手动发送 |
trace.emit() | 便捷发送（扩展方法） |
FxTrace.minLogLevel | 全局日志级别阈值 |
LogTrace(msg, level: ...) | 日志 |
TipTrace(msg, code) | 提示 |
TipTrace.warning(msg, code) | 警告提示 |
CatchTrace(error, stack) | 捕获异常 |
Trace mixin使用 fx_boot_starter 接入 App 启动流程。适用于需要闪屏页、初始化异步任务、启动状态管理的场景。
使用 fx_dio 进行 Flutter HTTP 请求开发。基于实际项目实践的模式，包含 Host 定义、请求发起、返回值处理、异常追踪等核心流程。
使用 fx_event 进行类型化事件通信。适用于回调层级过深、跨模块通信、远距离组件交互、异步请求-响应等场景。
使用 fx_exception 构建统一异常追踪体系。提供 Code、Trace、TraceMixin 三个核心协议，各模块基于此扩展自定义异常。