Skip to content

Changelog

ft-sdk

1.7.1 (2026/04/30)

  1. Added View RUM metric view_long_task_rate to count the proportion of total Long Task duration within the View lifecycle, with a maximum value of 1.
  2. Added crash RUM Error metrics foreground_crash_free_duration and background_crash_free_duration to distinguish foreground and background crash-free operation durations.
  3. Added Resource network snapshot fields, including network_available, network_validated, network_downlink_kbps, network_uplink_kbps, and network_signal_strength.
  4. SDK data synchronization now enables deflate compression by default, which can be disabled via FTSDKConfig.setCompressIntakeRequests(false).
  5. Fixed version dependency constraints between ft-sdk and Session Replay modules, improving integration compatibility check accuracy.

1.7.0 (2026/04/17)

  1. Added Session Replay capability, supporting WebView Session Replay, DCloud WebView, and full snapshot keyframe collection for WebView containers.
  2. Added Session Replay and RUM context association capability, allowing association between WebView containers and the context of loaded HTML content.
  3. Added Session Replay error sampling capability and support for dynamic control of Session Replay via remote configuration.
  4. Added Session Replay image resource upload capability, supplemented with parameter passthrough like userAgent, appVersion, and synchronization link adaptation.
  5. Optimized Session Replay initialization, shard frame complementation, frame generation and consumption, delayed writing, disk write limiting, and other logic to improve recording and synchronization stability.
  6. Fixed issues such as WebView data loss, abnormal handling in invisible scenarios, premature writing causing white screens, inability to synchronize with low-version OkHttp, and recording failures due to Bitmap recycling.
  7. Fixed crash issues caused by calling related methods on some controls before layout completion, improving overall stability and compatibility.

1.6.17 (2026/3/25)

  1. Fixed an issue introduced in version 1.6.16: remote dynamic configuration not taking effect on first load.
  2. Added TraceContext and TraceContext.Simple for custom Trace Header handling. By overriding HeaderHandler.getTraceContext(Request), headers, traceId, and spanId can be provided at once, fully compatible with existing getTraceHeader, getTraceID / getSpanID implementations.
  3. Support for dynamically changing transmission addresses via FTSdk.setDatakitUrl(url), FTSdk.setDatawayUrl(datawayUrl, clientToken).

1.6.16 (2026/1/08)

  1. Added illegal character filtering for globalContext and attribute keys.
  2. Expanded resource_type support range, adding image, media, font, CSS, JS, and native types.
  3. Support for custom parsing and configuration of remote variables via FTSDKConfig.setRemoteConfigurationCallBack(FTRemoteConfigManager.FetchResult), FTSdk.updateRemoteConfig(int remoteConfigMiniUpdateInterval, FTRemoteConfigManager.FetchResult result). Custom parsing and configuration.
  4. Added resource_http_protocol, resource_request_size, resource_connection_reuse fields to Resource.
  5. Refined cold start time metrics, adding app_pre_application_init_time, app_application_init_time, and app_first_frame_init_time.
  6. Added compatibility support for OkHttp versions 3.12 and above.
  7. Fixed inaccurate Resource request start time issue.
  8. Fixed occasional null pointer exceptions when obtaining Action and View during SDK shutdown.
  9. Optimized error stack format, fixing line break errors in specific scenarios.
  10. Added limited Long Task monitoring capability when the application is in the background.
  11. Optimized Session refresh mechanism when the application is in the background.
  12. Optimized nanosecond-level time calculation logic in Action, View, and Resource.

1.6.15 (2025/12/03)

  1. Optimized FPS monitoring mechanism: starts on the main thread, automatically stops monitoring when the app goes to the background.
  2. Optimized long log output mechanism for logs exceeding 4K, improving log readability and completeness.
  3. Optimized generation logic for resource, long task, and error within View context.
  4. Increased View generation rate and reduced traffic data generated with the same view_id.
  5. Removed restrictions on ActivityLifecycleCallbacks in child processes, making lifecycle monitoring more complete.
  6. Fixed occasional View data update loss issue.
  7. Fixed session refresh anomalies caused by asynchronous network requests.
  8. Fixed issue where idle DB release could not be triggered after SDK shutdown and re-initialization.

1.6.14 (2025/08/20)

  1. Used ContentProvider to optimize compatibility issues in high-load multi-process data collection scenarios.
  2. Removed SDK AndroidManifest declaration for android.permission.READ_PHONE_STATE. Integrators need to add it themselves based on actual needs. Permission usage instructions can be found in the integration documentation.
  3. Restricted data synchronization in child processes. Data collected by child processes will be reported by the main process.

1.6.13 (2025/08/10)

  1. Added FTRUMConfig.setActionTrackingHandler to support custom user action tracking. This handler allows developers to customize how user actions (app launch, clicks) are tracked in RUM data. Developers can modify action names, add custom attributes, or skip tracking specific actions.
  2. Added FTRUMConfig.setViewActivityTrackingHandler to support custom Activity page tracking. This handler allows developers to customize how Activity pages are tracked in RUM data. Developers can modify page names, add custom attributes, or skip tracking specific Activities.
  3. Added FTRUMConfig.setViewFragmentTrackingHandler to support custom Fragment page tracking. This handler allows developers to customize how Fragment pages are tracked in RUM data. Developers can modify page names, add custom attributes, or skip tracking specific Fragments.
  4. Fixed issue where FTRUMGlobalManager.addAction lacked binding information like userid from bindUserData.
  5. Added load_time data metric for Fragment in View.
  6. Added FTRUMGlobalManager.updateTime for customizing the current view's load time.
  7. Improved compatibility with OkHttp 3.12.x versions.
  8. Tags added via FTRUMConfig.appendRUMGlobalContext can be updated during the session.

1.6.12 (2025/06/11)

  1. Added FTRUMConfig.setEnableTraceWebView to configure whether to enable WebView data collection via Android SDK. Use FTRUMConfig.setAllowWebViewHost to control host addresses that need filtering.
  2. Added ContentHandlerHelperEx.onExceptionWithFilter to filter local network errors.
  3. Added FTSDKConfig.setRemoteConfiguration to support enabling remote conditional configuration. Added FTSDKConfig.setRemoteConfigMiniUpdateInterval to set the minimum update interval after enabling remote control.

1.6.11 (2025/05/15)

  1. Added FTRUMConfig.setEnableTraceUserViewInFragment to support fragment view data collection, default is false.
  2. Added FTSDKConfig.setLineDataModifier, FTSDKConfig.setDataModifier to support data write replacement and data desensitization.
  3. Added FTRUMConfig.setSessionErrorSampleRate to support error sampling. When not sampled by setSamplingRate, errors can trigger sampling collection of RUM data from 1 minute prior.
  4. When FTSDKConfig.setEnableAccessAndroidID(false), use a local random uuid as device_uuid.
  5. Optimized high-frequency log writing, data synchronization, and idle shutdown logic.

1.6.10 (2025/04/18)

  1. Added FTSDKConfig.setEnableOkhttpRequestTag to support adding unique ResourceID to okhttp requests, solving the issue of incorrect trace_id and span_id displacement in high-concurrency identical requests. ft-plugin version 1.3.5 and above supports automatic ResourceID addition.
  2. Fixed circular invocation issue when RUM configuration is initialized multiple times, interacting with other crash collection SDKs.
  3. When navigating from a native page to a WebView page, use the native page name to populate view_referrer.
  4. Fixed issue where IOException from network requests was re-thrown, altering the original exception type.
  5. Added setProxy, setProxyAuthenticator, setDns to FTSDKConfig for configuring Proxy, ProxyAuthenticator, and Dns for OkHttp data synchronization network requests.
  6. OkHttp data synchronization network requests support DNS IP round-robin connection for known hostNames.

1.6.9 (2025/03/07)

  1. Modified isAppForeground judgment mechanism to adapt to privacy-sensitive information detection.
  2. Added resource data fields resource_first_byte_time, resource_dns_time, resource_download_time, resource_connect_time, resource_ssl_time. Supports enhanced Resource duration display on TrueWatch and alignment with APM flame graph timeline.
  3. Optimized synchronization retry mechanism, removed the configuration option FTSDKConfig.setDataSyncRetryCount(0) for direct data discard.
  4. FTSDKConfig.enableDataIntegerCompatible is enabled by default for compatibility with web numeric floating-point data types.
  5. Fixed issue where repeated initialization of RUM configuration caused duplicate crash data generation.

1.6.8 (2025/01/21)

  1. Fixed inaccurate fps collection when RUM configuration is initialized multiple times.
  2. Added fault tolerance for old version cache data upgrade.
  3. Migrated FTRUMConfig.setOkHttpTraceHeaderHandler to FTTraceConfig.setOkHttpTraceHeaderHandler.
  4. Enhanced WebView SDK internal information and optimized performance.

1.6.7 (2025/01/10)

  1. Support for custom FTTraceInterceptor.HeaderHandler association with RUM data.
  2. Support for modifying ASM-written FTTraceInterceptor.HeaderHandler content via FTRUMConfig.setOkHttpTraceHeaderHandler, and modifying ASM-written FTResourceInterceptor.ContentHandlerHelper content via FTRUMConfig.setOkHttpResourceContentHandler.
  3. Optimized crash collection capability, adapting to scenarios where system.exit triggered by certain OS prevents crash data collection.
  4. Fixed occasional issue where tags were empty strings, causing data reporting failure.
  5. Optimized ASM OkHttpListener EventListener coverage logic, supporting preservation of original project EventListener event parameter passing.

1.6.6 (2024/12/27)

  1. Optimized network status and type acquisition, supporting ethernet network type display.
  2. Optimized frequent database closure issue when writing data in no-network state.
  3. Fixed discrepancy between discarded log/RUM old data entry count and configured entry count.
  4. Adapted TV device key events, removing non-TV device tags.
  5. Support for limiting RUM data cache entry count upper limit via FTRUMConfig.setRumCacheLimitCount(int), default 100_000.
  6. Support for limiting total cache size via FTSDKConfig enableLimitWithDbSize(long dbSize). After enabling, FTLoggerConfig.setLogCacheLimitCount(int) and FTRUMConfig.setRumCacheLimitCount(int) will become ineffective.
  7. Optimized Session refresh rules when the device is idle.

1.6.5 (2024/12/24)

  1. Weakened prompts for null parameters during WebView AOP process.
  2. Optimized long Session update mechanism when the application is in the background.

1.6.4 (2024/12/03)

  1. Optimized App startup time statistics for API 24 and above.
  2. Support for setting detection time range via FTRUMConfig.setEnableTrackAppUIBlock(true, blockDurationMs).

1.6.3 (2024/11/18)

  1. Optimized performance of custom addAction during high-frequency calls.
  2. Support for configuring deflate compression for synchronized data using FTSDKConfig.setCompressIntakeRequests.

1.6.2 (2024/10/24)

  1. RUM added addAction method, supporting property extension attributes and frequent continuous data reporting.

1.6.1 (2024/10/18)

  1. Fixed issue where custom startView called separately in RUM caused monitoring metric FTMetricsMTR thread not being recycled.
  2. Support for adding dynamic attributes via FTSdk.appendGlobalContext(globalContext), FTSdk.appendRUMGlobalContext(globalContext), FTSdk.appendLogGlobalContext(globalContext).
  3. Support for clearing unreported cached data via FTSdk.clearAllData().
  4. SDK setSyncSleepTime maximum limit extended to 5000 ms.

1.6.0 (2024/08/18)

  1. Optimized data storage and synchronization performance. (Upgrading from older versions to 1.6.0 requires configuring FTSDKConfig.setNeedTransformOldCache for old data compatibility synchronization.)
  2. Fixed issue where using ft-plugin and calling Log.w(String,Throwable) caused an exception.

1.5.2 (2024/07/10)

  1. Added local network error type hints to Error network_error, supplementing scenarios where resource_status=0 in Resource data.
  2. Fixed uncaughtException rethrow propagation issue when setEnableTrackAppCrash(false).

1.5.1 (2024/06/19)

  1. Added other thread code stacks to Java Crash and ANR.
  2. Added additional logcat configuration functionality to Java Crash, Native Crash, and ANR.
  3. Fixed issue where session_id was frequently updated during long sessions with no action updates.

1.5.0 (2024/06/03)

  1. Added remote IP address resolution functionality to RUM resource network requests.
  2. Fixed array thread safety issue caused by high-concurrency network requests when RUM SampleRate is enabled.
  3. Fault tolerance optimization for ConnectivityManager.registerDefaultNetworkCallback method.
  4. Added line protocol Integer data compatibility mode to handle web data type conflicts.
  5. Optimized automatic collection of control resource name id in Action click.
  6. Fault tolerance optimization for SDK config configuration reading exceptions.

1.4.6 (2024/05/15)

  1. SDK initialization fault tolerance optimization.
  2. Added new log type Status.Debug.
  3. Adjusted console log capture level correspondence: Log.i -> info, Log.d -> debug.
  4. FTLogger custom logs support custom status field.

1.4.5 (2024/04/26)

  1. Compatibility optimization for repeated initialization.
  2. Optimized c/c++ crash collection data synchronization logic to avoid deadlocks caused by unexpected termination in certain scenarios.
  3. Optimized startAction Property attribute writing logic to avoid thread-safe access issues.

1.4.4 (2024/04/01)

  1. Database connection fault tolerance protection.
  2. Fixed issue where child process configuration partially ineffective when setOnlySupportMainProcess true.
  3. Fixed issue where Crash would not rethrow when RUM View collection not enabled.

1.4.3 (2024/03/22)

  1. Support for Dataway and Datakit address upload.
  2. Support for sending RUM data types: Action, View, Resource, LongTask, Error.
  3. View, Action page navigation, control click automatic collection require ft-plugin.
  4. Resource, automatic collection, only supports Okhttp, and requires ft-plugin.
  5. Native Crash and ANR in Error require ft-native.
  6. Support for sending Log data, automatic console writing requires ft-plugin.
  7. Trace http header propagation, only supports Okhttp, and requires ft-plugin.
  8. Support for data synchronization parameter configuration: request entry count, synchronization interval time, and log cache entry count.
  9. Support for converting SDK internal logs to files.

More logs

ft-session-replay

0.1.4 (2026/04/30)

  1. Removed redundant Kotlin dependencies, simplifying Session Replay dependency relationships.
  2. Improved public API documentation for Session Replay configuration, privacy control, custom Mapper extensions, resource upload callbacks, etc., enhancing IDE hints and custom extension development experience during Java/Kotlin integration.

0.1.3 (2026/04/17)

  1. Added WebView Session Replay capability, supporting DCloud WebView and full snapshot keyframe collection for WebView containers.
  2. Added Session Replay and RUM context association capability, allowing association between WebView containers and the context of loaded HTML content.
  3. Added error sampling capability and support for dynamic control of Session Replay via remote configuration.
  4. Added image resource upload capability, improved metadata processing for userAgent, appVersion, forceFullSnapshot, etc.
  5. Optimized frame generation and consumption, shard frame complementation, WebView Replay data delayed writing, invisible WebView handling, and disk write limiting, improving stability and performance.
  6. Fixed issues: WebView Replay data loss, premature writing causing white screens, synchronization failure with low-version OkHttp, recording failure due to Bitmap recycling, rumLinkKey null handling, and recording timeout in multi-image scenarios.

More logs

ft-session-compose

  1. Fixed crash issue when recording AndroidView interop nodes, caused by low-version Session Replay Core missing MappingContext.getInteropViewCallback().
  2. Added consumer ProGuard rules to preserve MappingContext AndroidView interop callback access methods required by Compose Replay.
  3. Improved documentation for Compose Replay's Modifier privacy coverage, extension support, text truncation modes, and image Wireframe helper methods, enhancing IDE hints during Kotlin/Compose integration.
  4. Added Jetpack Compose Session Replay support, enabling recording and playback for ComposeView and AndroidComposeView scenarios.
  5. Supports semantic mapping and playback for common Compose components, including text, text input fields, buttons, images, sliders, Switch, Checkbox, RadioButton, Tab, and container nodes.
  6. Supports Session Replay privacy coverage via Modifier in Compose, including node hiding, image privacy, text and input privacy, touch privacy.
  7. Current Compose playback is based on semantic node mapping and does not guarantee pixel-perfect reproduction; Brush backgrounds are not yet supported, e.g., linear gradients, radial gradients will not be played back with original effects.

More logs

ft-session-material

  1. Version 0.1.4 aligned with ft-session-replay, no API or behavioral changes.
  2. Added Session Replay support for Material components, including CardView and Chip.
  3. Optimized compatibility and debugging support for lower Android versions.
  4. Optimized rendering performance of Material components in Replay data, updated MaterialDrawableToColorMapper rules.
  5. Aligned versioning strategy with ft-session-replay, improving release management and integration consistency.

More logs

ft-native

1.1.3 (2026/04/30)

  1. Enhanced Native Crash backtrace robustness, added null address detection, and strengthened null pointer and wild pointer checks during libunwind.so backtracing in libft_native_exp_lib.so.
  2. Fixed potential secondary crash issue of libunwind.so during Native Crash handling.

1.1.2 (2025/07/18)

  1. Adapted to Android 16K page size (compatible with Android 15+).

1.1.1 (2024/06/22)

  1. Added logcat configuration functionality to Native Crash and ANR.

1.1.0 (2024/03/22)

  1. Supports capturing ANR Crash.
  2. Supports capturing C/C++ Native Crash.
  3. Supports collecting application runtime state upon crash.
  4. Supports callbacks triggered by ANR and Native Crash.

More logs

ft-plugin ( AGP >=7.4.2 )

1.3.6 (2025/12/03)

  1. Supports UniApp WebView.
  2. Added knownWebViewClasses parameter to support ASM writing.
  3. Added functionality to output logs to files.
  4. Added verboseLog parameter for more verbose log output.
  5. Added numerical boundary handling in FTMethodAdapter.
  6. Added ignore configuration to filter internal methods of custom WebViews.

1.3.5 (2025/04/18)

  1. Optimized stability of plugin parameters during concurrent compilation.
  2. Added ASM writing for FTAutoTrack.trackRequestBuilder method, requires ft-sdk version 1.6.10 or above.
  3. Supports automatic capture of Log.println logs, requires ft-sdk version 1.6.8 or above.

1.3.4 (2024/12/11)

  1. Optimized error log output.
  2. Fixed issue where sourcemap symbol file not generated when minifyEnabled not enabled.
  3. Supports generating sourcemap without active upload via generateSourceMapOnly true.

1.3.3 (2024/09/04)

  1. Optimized automatic acquisition and upload of native symbol so, supports custom nativeLibPath specification.

1.3.2 (2024/08/13)

  1. Supports automatic capture of React Native WebView events.

1.3.1 (2024/07/04)

  1. Added asmVersion configuration function, supports asm7 - asm9, defaults to asm9.
  2. Fixed issue where custom WebView methods caused circular calls after ASM writing, preventing WebView content loading. (Involved methods: loadUrl, loadData, loadDataWithBaseURL, postUrl).
  3. IgnoreAOP supports declaration within a class to ignore all methods in that class.
  4. Added ignorePackages configuration, supports ignoring ASM via package path configuration.

1.3.0 (2024/03/22)

  1. Supports automatic upload of datakit source map and native symbol upload.
  2. Supports capturing Application cold/warm start, Activity page navigation, View, ListView, Dialog, Tab click events.
  3. Supports writing WebView Js listener methods.
  4. Supports automatic writing of Okhttp Trace and Resource data.
  5. Supports Gradle 8.0, AGP 8.0.
  6. Supports IgnoreAOP ignore marker.
  7. Supports compatibility with Alibaba Cloud hotfix framework.

More logs

ft-plugin-legacy ( AGP <=7.4.2 )

1.1.9 (2025/12/09)

  1. Supports UniApp WebView.
  2. Added knownWebViewClasses parameter to support ASM writing.
  3. Added functionality to output logs to files.
  4. Added verboseLog parameter for more verbose log output.
  5. Added numerical boundary handling in FTMethodAdapter.
  6. Added ignore configuration to filter internal methods of custom WebViews.

1.1.8 (2024/08/13)

  1. Supports automatic capture of React Native WebView events.

1.1.7 (2024/07/04)

  1. Fixed issue where overriding methods in WebView subclasses caused circular calls after ASM writing, preventing WebView content loading. (Involved methods: loadUrl, loadData, loadDataWithBaseURL, postUrl).
  2. IgnoreAOP supports declaration within a class to ignore all methods in that class.
  3. Added ignorePackages configuration, supports ignoring ASM via package path configuration.

1.1.6 (2024/03/22)

  1. Supports automatic upload of datakit source map and native symbol upload.
  2. Supports capturing Application cold/warm start, Activity page navigation, View, ListView, Dialog, Tab click events.
  3. Supports writing WebView Js listener methods.
  4. Supports automatic writing of Okhttp Trace and Resource data.
  5. Supports AGP versions below 7.4.2.
  6. Supports IgnoreAOP ignore marker.
  7. Supports compatibility with Alibaba Cloud hotfix framework.

More logs