更新日志¶

ft_sdk¶

0.1.17 (2026/09/11)¶

1. 新增 setEnableConsoleLog(...) 与 @cloudcare/hvigor-ohos-plugin，支持自动采集 console.* 和 hilog.* 日志；需同时接入 Plugin 并开启日志配置。其可选 prefix 参数既支持普通消息前缀，也支持按 message、log_source 和 HiLog 的 tag、domain 配置 DataKit 允许规则；日志等级仍由 setLogLevelFilters(...) 控制，规则在自动日志进入 SDK 队列前生效。
2. 新增基于编译插件的冷启动采集，自动上报进程启动、AbilityStage 初始化、首个 UIAbility 创建和首帧耗时，无需手动记录生命周期。
3. 新增 FTRUMConfig.setResourceUrlHandler(...)，支持过滤 RCP、Axios 和 NetworkKit 自动 Resource；不影响 Trace Header 注入和手动 Resource。
4. 新增文件缓存治理能力，支持总缓存容量限制、丢弃策略、FileStore 直接上传和旧缓存迁移。
5. 新增 FTRUMConfig.setViewTrackingHandler(handler, type)，支持按 Router、Navigation 或全部自动 View 过滤、重命名和添加属性；处理器接收包含来源页面信息的 FTViewTrackingContext。
6. 新增 NetworkKit 和 @ohos/axios Resource 性能时序采集与瀑布图阶段映射；当性能时序缺失，或最终时间点早于前一阶段时，改为回退使用实际测得的请求总耗时，避免产生无效阶段。
7. 优化 FileStore 的写入、容量统计和恢复诊断能力，提升文件缓存与影子写入场景的稳定性。
8. 优化远程数据过滤规则刷新机制：上传任务启动时按 pull_interval 检查更新，数值间隔按纳秒解析，服务端内容未变化时不重复处理。
9. 修复自动 Resource 在所属 Action 关闭后完成时，Resource/Error 计数和 Action 关联可能丢失的问题。
10. 修复 Action 已关闭时 Resource 完成后 View 的 Resource 和待处理计数未及时刷新的问题。
11. 修复 RCP Resource 瀑布图首字节与下载阶段使用重建时长计算，导致传输阶段缺失或阶段时长异常的问题。
12. 修复超时和连接失败等未返回 HTTP 响应的 Resource 及关联 Network Error 缺少 resource_status=0 的问题。
13. 修复 Worker 生成的 Action、Resource、Error 及 Resource 生成的 Network Error 缺少已绑定用户和网络属性的问题。
14. 修复自定义 LineDataModifier 处理后 Action、Resource、Error 及关联 Network Error 丢失 SDK 公共属性的问题。
15. 修复 Axios 和 NetworkKit 请求在完成时未提供网络状态但存在有效耗时时，自动 Resource 可能被丢弃的问题。

0.1.16 (2026/08/31)¶

1. 新增 RUM 设备指标采集，可通过 setDeviceMetricsMonitorType(...) 配置 View 的 CPU、内存、电池电流和 FPS，通过 setExtraMonitorTypeWithError(...) 为 Error 添加 CPU、内存和电池指标。既有 setDeviceMetricsDetectFrequency(...) 和单参数 setDeviceMetricsMonitorType(...) 调用仍可继续使用。
2. 新增 FTRUMConfig.setActionTrackingHandler(...)，可过滤自动 Click Action：返回 null 跳过采集，返回 undefined 保持默认采集。
3. 修复 UI 卡顿 LongTask 的时长计算，改用系统 MAIN_THREAD_JANK 事件。
4. 修复 EventConsumer Worker 重启后 RUM Action、Resource、Error 偶发缺失 app_id 的问题，确保数据关联到已配置的 RUM 应用。
5. 修复原生和 WebView Resource 及其生成的 Network Error 的 resource_id 未使用稳定 UUID 的问题，便于关联查询。
6. 修复重试上传时 RUM 数据可能重复上报的问题，保留并复用原始 sdk_data_id。
7. 变更 WebView 数据补充规则：不再自动补充 view_path_name；缺失 view_referrer 时回退到当前原生 View。
8. 变更自动 Action 默认名称为 组件类型/组件文本#组件ID；列表和 Tab 中的组件追加 #position:n。
9. 变更远程数据过滤规则：启用 setEnableDataFilter(true) 并配置有效上报地址后自动拉取；规则更新时清理命中的缓存数据。
10. 优化离线数据上传：重试耗尽后等待外部触发，不阻塞后续可上传数据。

0.1.15 (2026/07/29)¶

1. 新增 DataModifier，支持修改或脱敏 Log、原生 RUM 与 WebView RUM 的字段和标签；字段回调返回 null 时保留原值。
2. 新增 LineDataModifier 行级数据补丁能力；回调接收合并后的数据，仅覆盖返回补丁中存在的字段，返回 null 或空 Map 时不修改数据。
3. 新增 RUM 与 Logging 数据过滤能力，默认启用；可通过 setEnableDataFilter(...) 控制开关，并通过 setDataFilters(...) 配置本地规则；本地与远程规则共同生效，命中规则的数据不会写入本地缓存。
4. 新增运行时上报地址切换能力，可通过 FTSDK.setDatakitUrl(...) 或 FTSDK.setDatawayUrl(..., clientToken) 切换地址；切换后自动刷新远程配置，DataWay 模式需提供客户端 Token。
5. 新增远程配置能力；启动时会合并本地缓存与已支持的运行时更新项，可通过 setRemoteConfiguration(...) 开启，并使用 updateRemoteConfig(...) 手动刷新。
6. 新增 RUM Action API 扩展：addAction 支持设置时长和扩展属性，startAction 支持设置扩展属性。
7. 移除 addActionWith...、startActionWith... 与未完成的公开 stopAction API；请迁移至 addAction、startAction。
8. 新增 Resource 生命周期扩展属性支持；startResource、stopResource 的属性会按调用顺序与 ResourceParams 合并。
9. 移除公开 stopResource 中未使用的 statusCode 与 contentLength 参数；请删除对应调用参数。
10. 变更 addError 重载形式；dateline 可置于 errorType 前，Worker 回调不再作为公开接口。

0.1.14 (2026/07/17)¶

1. 优化 Error 与 Resource 采集链路，移除正常采集过程中的高频内部 Debug 日志。
2. 新增上传请求压缩配置，可通过 setCompressIntakeRequests(...) 控制；默认启用 deflate，不可用时回退为明文上传。
3. 新增自动同步与上传控制配置，可使用 FTSDKConfig.setAutoSync(...) 设置初始化状态，或通过 FTSDK.setAutoSync(...) 在运行时变更同步状态；默认自动上传使用 10 秒聚合窗口，关闭后或需要立即上传时可调用 FTSDK.flushSyncData()。
4. 新增同步分页配置，可通过 setSyncPageSize(...) 设置预定义分页，或通过 setCustomSyncPageSize(...) 自定义同步条目数。
5. 新增上传网络配置，可通过 setProxy(...)、setProxyAuthenticator(...)、setDns(...) 分别设置代理、代理认证和 DNS。
6. 优化线程池与串行数据库任务处理，提升高并发场景下的数据一致性。
7. 优化 ANR 与 Crash Worker 的空闲回收策略，Worker 按需重建。
8. 变更 Native Crash 诊断日志采集条件：仅在已配置 RUM App ID 且启用 FTRUMConfig.setEnableTrackAppCrash(true) 时收集。
9. 新增 SDK 调试配置，可通过 FTSDKConfig.setSdkLogLevel(...) 设置日志级别，并通过 FTSDKConfig.setEnableInnerLogFile(...) 写入内部日志文件。
10. 新增 FTTraceConfig.setTraceHeaderHandler(...)，可为单次请求提供自定义 Trace 上下文，供 SDK 注入请求 Header 并关联 RUM Resource。
11. 变更 RUM 与 Log 缓存数量配置：RUM 缓存数量改由 FTRUMConfig.setRumCacheLimitCount(...) 设置；Log 缓存数量继续使用 FTLoggerConfig.setLogCacheLimitCount(...)。
12. 变更公共导出：通过根目录 Index 导出 WebView 接入、高级 RCP 拦截器组装和 Trace 拦截器类型，无需再从内部路径导入。
13. 修复 View 数据确认时动态属性（包括用户数据）缺失的问题。
14. 修复随机分配用户 ID 偶发不稳定的问题。
15. 新增 @ohos/axios 自动采集兼容路径：不支持 interceptorChain 的 axios 版本可调用 applyFTAxiosTrack(...)，通过请求和响应拦截器采集数据。

更多日志

@cloudcare/hvigor-ohos-plugin¶

0.1.1 (2026/09/14)¶

1. 修复同时启用冷启动和 console.*、hilog.* 自动采集时，控制台日志插桩可能未生效的问题。

0.1.0 (2026/09/14)¶

1. 新增编译期插桩，支持自动采集 console.* 和 hilog.* 日志。
2. 新增冷启动编译期插桩，支持自动记录冷启动关键阶段。
3. 修复冷启动首帧观察在 WindowStage.loadContent(...) 完成前注册失败的问题，加载成功后会自动重试。

更多版本

ft_sdk_ext¶

0.1.17 (2026/09/11)¶

1. 新增 NetworkKit 响应性能时序采集，并传递给 Resource 瀑布图；性能时序缺失或无效时，回退使用实际请求总耗时。
2. 修复 NetworkKit 拦截器链路中未返回 HTTP 响应的传输失败仅产生 responseCode=0 Resource、缺少关联 Network Error 的问题；现会同时上报含诊断错误信息的 Resource 和 Network Error，不改变调用方原有失败结果。

0.1.16 (2026/08/31)¶

1. 变更 ft_sdk_ext 版本至 0.1.16，作为版本对齐更新，拦截器 API 与行为无变化。

0.1.15 (2026/07/29)¶

1. 变更 ft_sdk_ext 版本至 0.1.15，作为版本对齐更新，拦截器 API 与行为无变化。

0.1.14 (2026/07/17)¶

1. 变更 NetworkKit 拦截器的集成方式，使用版本化 FTSDKExtensionBridge 契约，避免 ft_sdk_ext 依赖 ft_sdk/src/main/... 等内部源码路径。
2. 变更最低兼容 API Level 至 22。
3. 变更 NetworkKit HttpInterceptor API 的分发方式，将其拆分至扩展 HAR；使用该 API 时请接入 ft_sdk_ext。
4. 新增 createFTHttpInterceptorChain(...)，支持 NetworkKit 自动采集。
5. 新增 applyFTHttpTrack(...)，支持接入 HTTP 自动采集。
6. 新增 applyFTAxiosChainMethodBridge(...)，支持 axios interceptorChain 自动采集。

更多日志

ft_native¶

0.1.2 (2026/09/11)¶

1. 优化 Native Crash 监控诊断日志：将正常路径中的详细 NAPI、信号处理和崩溃解析日志调整为 Debug 级别，并移除冗余生命周期日志；采集 API 和行为无变化。

0.1.1 (2026/07/29)¶

1. 变更 ft_native 版本至 0.1.1，作为版本对齐更新，Native Crash API 与行为无变化。

0.1.0 (2026/07/17)¶

1. 新增独立 Native Crash 采集能力。
2. 优化 Native Crash 采集逻辑：根据已安装的 ft_sdk 依赖自动适配，仅将真实原生崩溃传递给 FTNativeCrashAdapter；JavaScript Crash 继续由 ft_sdk 的 Error 采集链路处理，避免重复上报。

更多日志