更新日志¶

ft_sdk¶

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(...)，通过请求和响应拦截器采集数据。

更多日志

ft_sdk_ext¶

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.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 采集链路处理，避免重复上报。

更多日志