更新日志¶

ft_mobile_agent_flutter¶

0.5.7 (2026/07/09)¶

1. 适配 Android ft-sdk 1.7.3、Android ft-native 1.1.3、iOS FTMobileSDK 1.6.5。
2. 支持通过 ft_session_replay_flutter 接入 Flutter Session Replay。
3. 新增 FTMobileFlutter.sdkConfig(enableDataFilter, dataFilters)，支持配置 SDK 侧 DataKit 兼容过滤规则，可用于 logging 和 rum 数据过滤。
4. 新增远程配置 API：FTMobileFlutter.sdkConfig(enableRemoteConfiguration, remoteConfigMiniUpdateInterval, remoteConfigOverrideRules)、FTMobileFlutter.updateRemoteConfig() 和 FTMobileFlutter.updateRemoteConfigWithMiniUpdateInterval(...)。
5. 新增 Android 缓存总大小和 FileStore 配置：enableLimitWithCacheSize、cacheLimit、cacheDiscard、enableFileDataStore、needTransformOldCache、fileDataStoreShadow。
6. 新增 FTRUMManager().setConfig(enableTraceWebView, allowWebViewHost)，支持配置 Android SDK WebView 数据采集及允许采集的 Host。
7. 新增 FTRUMManager().setConfig(enableNativeSwiftUIUserView)，支持 iOS 原生 SwiftUI View 自动追踪。
8. 新增 Flutter LongTask 支持：FTRUMManager().setConfig(enableLongTask, dartLongTaskThreshold) 支持检测 Dart 主 Isolate 长任务，FTRUMManager().addLongTask(stack, duration) 支持手动上报 LongTask。
9. 新增 FTRUMManager().addAction(actionName, actionType)，支持高频 Action 写入场景，不与 Resource、LongTask 或 Error 事件做关联。
10. 新增 FTMobileFlutter.sdkConfig(customHttpOverrides)，支持在开启 HTTP 自动采集时传入自定义 HttpOverrides，减少与应用自定义网络代理逻辑的冲突。
11. 新增 FTMobileFlutter.shutDown()，支持关闭 SDK。
12. RUM Resource 上报补充 resourceType，并新增 requestSize、resourceHttpProtocol、reusedConnection、connectionReuse 等指标字段。
13. 修复调用 FTRUMManager().addError(...) 时 Error 堆栈可能错位的问题，以及 Android 调用 FTRUMManager().startAction(...) 时属性可能丢失的问题。

0.5.7-pre.4 (2026/07/09)¶

1. 新增 FTMobileFlutter.sdkConfig(enableDataFilter, dataFilters)，支持配置 SDK 侧 DataKit 兼容过滤规则，可用于 logging 和 rum 数据过滤。
2. 新增 Android 缓存总大小和 FileStore 配置：enableLimitWithCacheSize、cacheLimit、cacheDiscard、enableFileDataStore、needTransformOldCache、fileDataStoreShadow。
3. 新增 FTRUMManager().setConfig(enableNativeSwiftUIUserView)，支持 iOS 原生 SwiftUI View 自动追踪。
4. 新增 Flutter LongTask 支持：FTRUMManager().setConfig(enableLongTask, dartLongTaskThreshold) 支持检测 Dart 主 Isolate 长任务，FTRUMManager().addLongTask(stack, duration) 支持手动上报 LongTask。
5. RUM Resource 上报补充 resourceType，并新增 requestSize、resourceHttpProtocol、reusedConnection、connectionReuse 等指标字段。
6. Android Maven 仓库地址更新为 mvnrepo.guance.com。

0.5.6 (2025/06/16)¶

1. 添加 FTRUMManager().setConfig(sessionOnErrorSampleRate) 支持错误采样，在未被 setSamplingRate 采样时，在发生错误时可以对 1 分钟前的 rum 的数据进行取样采集。
2. 添加 FTMobileFlutter.sdkConfig(dataModifier, lineDataModifier) 支持数据写入替换，支持数据脱敏。
3. 适配 Android ft-sdk 1.6.11、iOS 1.5.16。

ft_mobile_agent_flutter 更多日志

ft_session_replay_flutter¶

0.1.0 (2026/07/09)¶

1. 新增 FTSessionReplayManager().setConfig(FTSessionReplayConfig(...)) 与 SessionReplayCapture，支持 Flutter Session Replay 数据采集。
2. 新增 Session Replay 隐私配置字段：touchPrivacy、textAndInputPrivacy、imagePrivacy。
3. 新增 FTSessionReplayConfig(enableSwiftUI)，支持开启 iOS 原生 SwiftUI 会话重放录制。
4. Android 依赖 ft-session-replay 升级至 0.1.6，并使用 ft-sdk:1.7.3 和 ft-native:1.1.3。
5. iOS 依赖 FTMobileSDK 1.6.5 与 FTMobileSDK/FTSessionReplay 1.6.5。
6. 当 SessionReplayCapture 已挂载后再应用 Session Replay 配置时，组件会重新注册录制状态，避免初始化时序导致无回放数据。

0.1.0-pre.1 (2026/07/09)¶

1. 新增 FTSessionReplayConfig(enableSwiftUI)，支持开启 iOS 原生 SwiftUI 会话重放录制。
2. Android 依赖 ft-session-replay 升级至 0.1.6-beta01，并继续使用 ft-sdk:1.7.3 和 ft-native:1.1.3。
3. Android Maven 仓库地址更新为 mvnrepo.guance.com。

0.1.0-dev.1 (2026/07/03)¶

1. 新增独立 Flutter Session Replay 插件包 ft_session_replay_flutter，Session Replay 不再由 ft_mobile_agent_flutter 提供。
2. 新包提供 FTSessionReplayManager、FTSessionReplayConfig、SessionReplayCapture、SessionReplayPrivacy 以及触控、文本输入、图片隐私配置枚举。
3. Android 依赖 ft-session-replay:0.1.6-alpha02、ft-sdk:1.7.3 和 ft-native:1.1.3；iOS 依赖 FTMobileSDK 1.6.5 与 FTMobileSDK/FTSessionReplay 1.6.5。
4. 建议按 FTMobileFlutter.sdkConfig(...)、FTRUMManager().setConfig(...)、FTSessionReplayManager().setConfig(...) 的顺序初始化，并使用 SessionReplayCapture 包裹需要录制的 Flutter 视图树。
5. 当 SessionReplayCapture 已挂载后再应用 Session Replay 配置时，组件会重新注册录制状态，避免初始化时序导致无回放数据。

ft_session_replay_flutter 更多日志