Changelog¶

0.4.1 (2026/04/22)¶

Added Session Replay capability, now available as a separate package @cloudcare/react-native-session-replay for independent installation and use.
Added Session Replay error sampling capability, supporting dynamic control of Session Replay via remote configuration.
Session Replay now supports privacy configuration for touch, text/input, and images via touchPrivacy, textAndInputPrivacy, and imagePrivacy. Added the native component FTSessionReplayView to mark and protect sensitive areas within React Native interfaces during session replay recording.
Added support for the new React Native architecture, improving compatibility with the latest React Native application configurations.
Supports dynamically updating data upload URLs via FTMobileReactNative.setDatakitURL and FTMobileReactNative.setDatawayURL.
Upgraded compatible versions: Android ft-sdk 1.7.0, Android ft-session-replay 0.1.3, and iOS SDK 1.6.2.

Adapted to Android ft-sdk 1.6.17 and iOS SDK 1.5.20.
Added FTRUMConfig.enableTraceWebView and FTRUMConfig.allowWebViewHost configuration items to support WebView collection rule configuration.
Added remoteConfiguration, remoteConfigMiniUpdateInterval, and remoteConfigOverrideRules to FTMobileConfig, supporting remote configuration, update interval control, and configuration override rules.
Added support for configuring iOS crash monitoring type via FTRUMConfig.iosCrashMonitoringType.
Supports adding context via the FTMobileReactNative.appendBridgeContext method to distinguish data sources or mark specific scenarios.

Added FTRUMConfig.sessionErrorSampleRate to support error sampling. When not sampled by sampleRate, it can sample RUM data from 1 minute prior when an error occurs.
Added FTMobileConfig.lineDataModifier and FTMobileConfig.dataModifier to support data write replacement and data desensitization.
Adapted to Android ft-sdk 1.6.10, 1.6.11, and iOS 1.5.15, 1.5.16.

Adjusted for Java 8 compatibility on Android, removed Kotlin library dependency.

Added RUM Resource data fields: resource_first_byte_time, resource_dns_time, resource_download_time, resource_connect_time, resource_ssl_time, resource_redirect_time. Supports enhanced display of Resource timing on TrueWatch and aligns with the timeline in the APM flame graph.
FTMobileConfig.enableDataIntegerCompatible is now enabled by default.
Adapted to Android ft-sdk 1.6.9, and iOS 1.5.12, 1.5.13, 1.5.14.

Optimized SDK configuration for hybrid development with native and React Native.
- Supports automatic collection of React Native control click events via the FTRumActionTracking.startTracking() method, and automatic collection of React Native error logs via the FTRumErrorTracking.startTracking() method.
- When RUM Resource auto-collection is enabled, added methods: FTReactNativeUtils.filterBlackResource(url) for iOS and ReactNativeUtils.isReactNativeDevUrl(url) for Android to filter React Native symbolization requests and Expo log requests in development environments, reducing redundant data.
Adapted to iOS SDK 1.5.11.

Modified the way native SDK header files are referenced in iOS bridge code.
Added RUM entry count limiting functionality. Supports limiting the maximum cached entry count via FTRUMConfig.rumCacheLimitCount. Supports specifying whether to discard new or old data via FTRUMConfig.rumDiscardStrategy.
Added support for limiting total cache size via FTMobileConfig.enableLimitWithDbSize. Once enabled, FTLoggerConfig.logCacheLimitCount and FTRUMConfig.rumCacheLimitCount become ineffective. Supports setting database discard strategy via FTMobileConfig.dbDiscardStrategy and database cache size limit via FTMobileConfig.dbCacheLimit.
Adapted to iOS SDK 1.5.8, 1.5.9, 1.5.10.
Adapted to Android SDK ft-sdk 1.6.6, 1.6.7, 1.6.8.

To improve React Android compatibility, changed part of the Android React Native Bridge from Kotlin to Java.
Adapted to Android SDK ft-sdk 1.6.5.

Fixed incorrect data type annotation for Android RN errors.
Supports setting freeze detection threshold via FTRUMConfig.nativeFreezeDurationMs.
Supports configuring deflate compression for synchronous data via FTMobileConfig.compressIntakeRequests.
Adapted to iOS SDK 1.5.6, 1.5.7.
Adapted to Android SDK ft-sdk 1.6.2, 1.6.3, 1.6.4.

Supports collection of Native Error, ANR, and Freeze.
Modified the default error type for automatically collected react-native errors.
For components with the onPress property, added support for defining whether to collect click events for that component via the custom attribute ft-enable-track, and adding extra Action properties via ft-extra-property, when enableAutoTrackUserAction is enabled.

Supports globally adding dynamic globalContext properties.
Supports custom error types via FTReactNativeRUM.addErrorWithType().
Supports shutting down the SDK via FTMobileReactNative.shutDown().
Supports clearing unsent cached data via FTMobileReactNative.clearAllData().
Fixed the issue where parameters stack and message were swapped when automatically collecting react-native errors.
Adapted to Android SDK ft-sdk 1.6.1.
Adapted to iOS SDK 1.5.4.

Fixed the issue where the Android configuration FTMobileConfig.env was ineffective.

Compatibility fix for errors when using react/jsx-runtime with React versions below 16.14.0.
Android compatibility with lower react-native versions (0.63).
Modified the regular expression for filtering URLs pointing to localhost (localhost) to increase the matching scope.
Adapted to iOS SDK 1.5.2.

Added support for configuring data synchronization parameters: request entry count, sync interval time, and log cache entry count.
Added remote IP address resolution for RUM resource network requests.
Added line protocol Integer data compatibility mode to handle web data type conflicts.
Added custom status method for logs.
Modified the react-native action collection method to adapt to the issue where React 17 cannot intercept click events from React.createElement.
In Debug scenarios, RUM Resource collection filters out hot update connections pointing to localhost (localhost).
Fixed Android underlying Double adaptation issue.