更新日志¶

UniApp¶

重构插件结构：
- GC-JSPlugin 统一提供公共 JS API，以及 View、Error、Resource、Action 采集器
- 新增 GC-UniPlugin 替换原生插件，提供 Android、iOS、HarmonyOS 三端 UTS 实现；普通 uni-app 通过命名导入获取带 interface 的 SDK API
- uni 小程序项目仅集成 GC-JSPlugin，由宿主 App 初始化 SDK 并提供宿主扩展
新增 HarmonyOS 支持

从 0.2.x 升级，请按照 UniApp 0.3.0 迁移指南完成插件结构迁移。

uni 小程序 iOS 宿主 App 升级注意： 0.2.7 的 GC_UniPlugin_App.xcframework 依赖的 iOS Native SDK 包名由 FTMobileSDK 变更为 GuanceSDK。从 0.2.6 及以下版本升级时，必须同时更新 GC_UniPlugin_App.xcframework 和 iOS Native SDK 1.6.7，不能只更新其中一项
适配 iOS 1.6.7、Android ft-sdk 1.7.5、ft-plugin 1.3.8 和 ft-native 1.1.3，iOS 最低支持版本调整为 12.0
GCUniPlugin-MobileAgent
- 新增 setDatakitURL、setDatawayURL，支持在未配置上报地址时初始化 SDK，后续可动态设置 Datakit 或 DataWay 地址
- 新增 remoteConfiguration、remoteConfigMiniUpdateInterval、updateRemoteConfigWithMiniUpdateInterval，开启远程条件配置功能
- 新增 enableDataFilter 和 dataFilters，开启 SDK 侧 DataFilter 并配置本地黑名单规则
- 修复 Android 未使用 ft-plugin 且 offlinePackage 为 false 时手动采集冷启动耗时和时间戳不准确的问题
GCUniPlugin-RUM
- 保持 enableTraceWebView 和 allowWebViewHost WebView RUM 配置兼容
GC-JSPlugin
- 新增 gcResourceTracking，为标准 uni.request 自动注入 Trace Header 并采集 RUM Resource；gcRequest 保留为废弃兼容 API
- 优化 gcViewTracking 页面生命周期采集，支持按页面实例维护状态、准确计算 onLoad 到 onReady 的加载耗时、清理失败路由并避免前后台切换重复采集

GCUniPlugin-RUM
- 支持通过 enableTraceWebView、allowWebViewHost 配置 WebView 采集规则
GC-JSPlugin
- GCErrorTracking：适配 Vue2 环境的错误数据采集功能

GC-JSPlugin
- 向 RUM View 中添加 view_url_query 字段
- 新增 GCViewTracking.js 支持通过 gcViewTracking.startTracking() 方法开启自动采集 RUM Views

GCUniPlugin-MobileAgent
- 支持通过 appendBridgeContext 方法添加上下文，以区分数据源或标记特定场景
GC-JSPlugin
- 新增 GC-JSPlugin 插件，将支持自动采集 RUM 相关数据的 js 文件重构为插件形式
- 添加 GCErrorTracking.js 支持自动采集错误信息
适配 iOS 1.5.17、 1.5.18 ，Android ft-sdk 1.6.12 、1.6.13 、1.6.14

修复 iOS 端 RUM enableNativeUserAction、enableNativeUserView、enableNativeUserResource ，Log enableLinkRumData、enableCustomLog，Trace enableAutoTrace 参数赋值 false 失效问题

GCUniPlugin-MobileAgent
- 支持通过 dataModifier，lineDataModifier 进行数据写入替换，支持数据脱敏
GCUniPlugin-RUM
- 支持通过 sessionOnErrorSampleRate 进行错误采样，在未被 samplerate 采样时，在发生错误时可以对 1 分钟前的 rum 的数据进行取样采集
在 iOS 端开启 RUM Resource 自动采集时，新增过滤方法过滤 dcloud 内部请求，减少冗余数据
适配 iOS 1.5.15、 1.5.16，Android ft-sdk 1.6.10、1.6.11

适配 iOS 1.5.9
Android ft-sdk 1.6.7, ft-native:1.1.1, ft-plugin-legacy 1.1.8
支持 Open Dataway 直传
支持 uni 小程序与原生 App 混合开发
GCUniPlugin-MobileAgent
- 支持通过 autoSync = false , flushSyncData() 自主管理数据同步时机，默认自动同步
- 支持通过 syncPageSize，syncSleepTime 设置数据同步页数大小和同步间歇时间
- 支持通过 compressIntakeRequests 对同步数据进行 deflate 压缩配置
- 支持通过 enableLimitWithDbSize = true，dbCacheLimit 开启数据同步缓存限制，并支持使用 dbDiscardStrategy 设置缓存超出上限后数据丢弃策略。设置之后 rumCacheLimitCount 和 logCacheLimitCount 设置将失效果
GCUniPlugin-RUM
- 支持通过 enableTrackNativeCrash 开启 Native Crash 监测。
- 支持通过 enableTrackNativeAppANR 开启 Native ANR 监测。
- 支持通过 enableTrackNativeFreeze 开启 Native Free 监测，通过 nativeFreezeDurationMs 设置监测阈值范围
- 支持通过 rumCacheLimitCount ，rumDiscardStrategy 限制 RUM 数据缓存条目数上限，默认 100_000
GCUniPlugin-Logger
- 支持通过 logCacheLimitCount 限制 RUM 数据缓存条目数上限，默认 5000

@cloudcare/rum-uniapp
- 新增 allowTraceHeaderWithoutSession 配置，默认值为 false；开启后，当前 Session 未命中 RUM 采样时，命中 allowedTracingOrigins 的请求仍会注入 Trace Header，但不会因此强制采样或上报该 Session 的 RUM 数据