Changelog¶

UniApp¶

0.3.0 (2026/08/20)¶

• Refactored plugin structure:
  • GC-JSPlugin now provides the common JS API along with View, Error, Resource, and Action collectors
  • Added GC-UniPlugin to replace the native plugin, providing UTS implementations for Android, iOS, and HarmonyOS; normal uni-app projects can import the SDK API with interfaces via named imports
  • Uni mini program projects only integrate GC-JSPlugin; the host App initializes the SDK and provides the host extension
• Added HarmonyOS support

When upgrading from 0.2.x, follow the UniApp 0.3.0 Migration Guide to complete the plugin structure migration.

0.2.7 (2026/08/19)¶

• Uni mini program iOS host App upgrade note: The iOS Native SDK package name used by the GC_UniPlugin_App.xcframework in 0.2.7 has been changed from FTMobileSDK to GuanceSDK. When upgrading from 0.2.6 or earlier, you must update both GC_UniPlugin_App.xcframework and the iOS Native SDK 1.6.7 at the same time; updating only one of them is not supported.
• Adapted to iOS 1.6.7, Android ft-sdk 1.7.5, ft-plugin 1.3.8, and ft-native 1.1.3; the minimum supported iOS version has been adjusted to 12.0
• GCUniPlugin-MobileAgent
  • Added setDatakitURL and setDatawayURL, allowing the SDK to be initialized without a configured upload address; the DataKit or DataWay address can be set dynamically later
  • Added remoteConfiguration, remoteConfigMiniUpdateInterval, and updateRemoteConfigWithMiniUpdateInterval to enable remote configuration
  • Added enableDataFilter and dataFilters to enable the DataFilter feature on the SDK side and configure local blacklist rules
  • Fixed an issue on Android where cold start duration and timestamps were inaccurate when manually collected without using ft-plugin and with offlinePackage set to false
• GCUniPlugin-RUM
  • Maintained compatibility for enableTraceWebView and allowWebViewHost WebView RUM configuration
• GC-JSPlugin
  • Added gcResourceTracking to automatically inject Trace Headers for standard uni.request and collect RUM Resources; gcRequest is retained as a deprecated compatibility API
  • Optimized gcViewTracking page lifecycle collection: now maintains state per page instance, accurately calculates loading time from onLoad to onReady, cleans up failed routes, and avoids duplicate collection when switching between foreground and background

0.2.6 (2026/01/05)¶

• GCUniPlugin-RUM
  • Added support for configuring WebView collection rules via enableTraceWebView and allowWebViewHost
• GC-JSPlugin
  • GCErrorTracking: adapted error data collection for Vue2 environments

0.2.5 (2025/10/31)¶

• GC-JSPlugin
  • Added the view_url_query field to RUM Views
  • Added GCViewTracking.js to support automatic RUM View collection via the gcViewTracking.startTracking() method

0.2.4 (2025/09/12)¶

• GCUniPlugin-MobileAgent
  • Added support for adding context via the appendBridgeContext method, to distinguish data sources or tag specific scenarios
• GC-JSPlugin
  • Added the GC-JSPlugin plugin, restructuring the JS files that support automatic RUM data collection into plugin form
  • Added GCErrorTracking.js to support automatic error collection
• Adapted to iOS 1.5.17, 1.5.18, Android ft-sdk 1.6.12, 1.6.13, 1.6.14

0.2.3 (2025/07/18)¶

• Fixed an issue on iOS where setting enableNativeUserAction, enableNativeUserView, enableNativeUserResource for RUM, enableLinkRumData and enableCustomLog for Log, and enableAutoTrace for Trace to false did not take effect

0.2.2 (2025/06/25)¶

• GCUniPlugin-MobileAgent
  • Added support for overriding data writing via dataModifier and lineDataModifier, enabling data masking
• GCUniPlugin-RUM
  • Added support for error sampling via sessionOnErrorSampleRate; when the session is not sampled by the samplerate, RUM data from the last 1 minute can be sampled and collected when an error occurs
• On iOS, when automatic RUM Resource collection is enabled, added a filter method to filter out dcloud internal requests, reducing redundant data
• Adapted to iOS 1.5.15, 1.5.16, Android ft-sdk 1.6.10, 1.6.11

0.2.1 (2025/03/18)¶

• Android: Fixed incorrect startup time logic when offlinePackage is false
• Android: Fixed a crash in pure uni-app projects when compressIntakeRequests is enabled
• GCUniPlugin-MobileAgent enableDataIntegerCompatible is now enabled by default
• Adapted to iOS 1.5.10, 1.5.11, 1.5.12, 1.5.13, 1.5.14, Android ft-sdk 1.6.8, 1.6.9

0.2.0 (2025/01/19)¶

• Adapted to iOS 1.5.9
• Android ft-sdk 1.6.7, ft-native:1.1.1, ft-plugin-legacy 1.1.8
• Added support for direct Open Dataway upload
• Added support for hybrid development with uni mini programs and native apps
• GCUniPlugin-MobileAgent
  • Added support for manual data synchronization via autoSync = false and flushSyncData(); automatic synchronization is enabled by default
  • Added support for setting the page size and sleep interval for data synchronization via syncPageSize and syncSleepTime
  • Added support for deflate compression of synchronized data via compressIntakeRequests
  • Added support for data cache size limits via enableLimitWithDbSize = true and dbCacheLimit, and the ability to set the discard strategy when the cache exceeds the limit via dbDiscardStrategy. When configured, rumCacheLimitCount and logCacheLimitCount are ignored
• GCUniPlugin-RUM
  • Added support for native crash monitoring via enableTrackNativeCrash
  • Added support for native ANR monitoring via enableTrackNativeAppANR
  • Added support for native freeze monitoring via enableTrackNativeFreeze, with the monitoring threshold configurable via nativeFreezeDurationMs
  • Added support for limiting the maximum number of RUM data cache entries via rumCacheLimitCount and rumDiscardStrategy; default is 100,000
• GCUniPlugin-Logger
  • Added support for limiting the maximum number of log data cache entries via logCacheLimitCount; default is 5,000

UniApp More Logs

Uni Mini Program¶

2.2.21 (2026/08/20)¶

• @cloudcare/rum-uniapp
  • Added performance fields such as page first render, FP, FCP, LCP, Ready status, page exit reason, and setData segmented duration
  • Added capability fields performance_supported and first_render_supported to calculate coverage and white screen candidates based on platform support
  • Added launch_attempt launch attempt event as the denominator for coverage of native startup performance entries
  • Performance entries are now attributed by route, pageId, and the latest navigationStart to avoid cross-page contamination caused by rapid page switching, same-route rebuilds, and delayed callbacks
  • Fixed an issue where the network type field was written inconsistently

2.2.20 (2026/08/11)¶

• @cloudcare/rum-uniapp
  • Added the allowTraceHeaderWithoutSession configuration option, defaulting to false; when enabled, requests matching allowedTracingOrigins will still have Trace Headers injected even if the current Session does not hit the RUM sampling rate, but this will not force sampling or report RUM data for that Session