Changelog¶

ft-sdk¶

1.6.14 (2025/08/20)¶

1. Optimized multi-process data collection in high-load scenarios using ContentProvider.
2. Removed the android.permission.READ_PHONE_STATE declaration from the SDK AndroidManifest. Integrators need to add it based on actual requirements. For permission usage, refer to 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 the tracking of user actions (app launches, clicks) in RUM data. Developers can modify action names, add custom attributes, or skip tracking for specific actions.
2. Added FTRUMConfig.setViewActivityTrackingHandler to support custom Activity view tracking. This handler allows developers to customize the tracking of Activity views in RUM data. Developers can modify view names, add custom attributes, or skip tracking for specific Activities.
3. Added FTRUMConfig.setViewFragmentTrackingHandler to support custom Fragment view tracking. This handler allows developers to customize the tracking of Fragment views in RUM data. Developers can modify view names, add custom attributes, or skip tracking for specific Fragments.
4. Fixed the issue where FTRUMGlobalManager.addAction lacked bindUserData-related information, such as userid.
5. Added load_time metric for Fragment in View.
6. Added FTRUMGlobalManager.updateTime to customize the loading time of the current view.
7. Improved compatibility with OkHttp 3.12.x.
8. Tags added via FTRUMConfig.appendRUMGlobalContext can now be updated during the session.

1.6.12 (2025/06/11)¶

1. Added FTRUMConfig.setEnableTraceWebView to configure whether to enable WebView data collection through the Android SDK. Use FTRUMConfig.setAllowWebViewHost to filter specific host addresses.
2. Added ContentHandlerHelperEx.onExceptionWithFilter to filter local network errors.
3. Added FTSDKConfig.setRemoteConfiguration to enable 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 and FTSDKConfig.setDataModifier to support data write replacement and data desensitization.
3. Added FTRUMConfig.setSessionErrorSampleRate to support error sampling. When not sampled by setSamplingRate, RUM data from 1 minute prior can be sampled when an error occurs.
4. When FTSDKConfig.setEnableAccessAndroidID(false) is set, a local random uuid is used as device_uuid.
5. Optimized high-frequency log writing, data synchronization, and idle data closure logic.

1.6.10 (2025/04/18)¶

1. Added FTSDKConfig.setEnableOkhttpRequestTag to support adding a unique ResourceID to OkHttp requests, resolving issues with trace_id and span_id misalignment in high-concurrency scenarios. ft-plugin 1.3.5 and above support automatic ResourceID addition.
2. Fixed the issue of circular calls with other crash collection SDKs when initializing RUM configurations multiple times.
3. When navigating from a native view to a WebView, the native view name is used to fill view_referrer.
4. Fixed the issue where IOException in network requests was rethrown, altering the original type.
5. Added setProxy, setProxyAuthenticator, and setDns to FTSDKConfig for configuring Proxy, ProxyAuthenticator, and Dns in OkHttp data synchronization network requests.
6. OkHttp data synchronization network requests now support DNS IP round-robin for known hostNames.

1.6.9 (2025/03/07)¶

1. Modified the isAppForeground judgment mechanism to adapt to privacy-sensitive information detection.
2. Added resource_first_byte_time, resource_dns_time, resource_download_time, resource_connect_time, and resource_ssl_time fields to resource data, enhancing Resource time display on Guance and aligning with the APM flame chart timeline.
3. Optimized the synchronization retry mechanism, removing the FTSDKConfig.setDataSyncRetryCount(0) option for direct data discard.
4. FTSDKConfig.enableDataIntegerCompatible is now enabled by default to ensure compatibility with web floating-point data types.
5. Fixed the issue of duplicate crash data generation when initializing RUM configurations multiple times.

1.6.8 (2025/01/21)¶

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

1.6.7 (2025/01/10)¶

1. Supported custom FTTraceInterceptor.HeaderHandler for association with RUM data.
2. Supported modifying ASM-written FTTraceInterceptor.HeaderHandler content via FTRUMConfig.setOkHttpTraceHeaderHandler and ASM-written FTResourceInterceptor.ContentHandlerHelper content via FTRUMConfig.setOkHttpResourceContentHandler.
3. Optimized crash collection to adapt to scenarios where system.exit triggered by certain OS prevents crash data collection.
4. Fixed the occasional issue where tags were empty, preventing normal data reporting.
5. Optimized ASM OkHttpListener EventListener coverage logic to retain original project EventListener parameter passing.

1.6.6 (2024/12/27)¶

1. Optimized network status and type acquisition, supporting ethernet type display.
2. Optimized database closure frequency in no-network states.
3. Fixed the issue where the number of discarded logs and RUM data entries deviated from the set number.
4. Adapted TV device button events, filtering non-TV device tags.
5. Supported limiting RUM data cache entry count via FTRUMConfig.setRumCacheLimitCount(int), defaulting to 100,000.
6. Supported limiting total cache size via FTSDKConfig enableLimitWithDbSize(long dbSize). When enabled, FTLoggerConfig.setLogCacheLimitCount(int) and FTRUMConfig.setRumCacheLimitCount(int) become invalid.
7. Optimized Session refresh rules in no-operation scenarios.

1.6.5 (2024/12/24)¶

1. Reduced the prominence of null parameter warnings in WebView AOP processes.
2. Optimized long Session update mechanisms for apps in the background.

1.6.4 (2024/12/03)¶

1. Optimized App launch time statistics for API 24 and above.
2. Supported setting detection time ranges via FTRUMConfig.setEnableTrackAppUIBlock(true, blockDurationMs).

1.6.3 (2024/11/18)¶

1. Optimized the performance of custom addAction in high-frequency calls.
2. Supported configuring deflate compression for synchronization data via FTSDKConfig.setCompressIntakeRequests.

1.6.2 (2024/10/24)¶

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

1.6.1 (2024/10/18)¶

1. Fixed the issue where custom startView calls in RUM caused the FTMetricsMTR monitoring thread to not be recycled.
2. Supported adding dynamic attributes via FTSdk.appendGlobalContext(globalContext), FTSdk.appendRUMGlobalContext(globalContext), and FTSdk.appendLogGlobalContext(globalContext).
3. Supported clearing unreported cached data via FTSdk.clearAllData().
4. Extended the maximum limit of SDK setSyncSleepTime 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.)
2. Fixed the issue where calling Log.w(String,Throwable) with ft-plugin caused exceptions.

1.5.2 (2024/07/10)¶

1. Added network_error type to Error for local network error scenarios, supplementing Resource data with resource_status=0.
2. Fixed the issue of uncaughtException rethrow when setEnableTrackAppCrash(false).

1.5.1 (2024/06/19)¶

1. Added additional thread code stacks for Java Crash and ANR.
2. Added logcat attachment configuration for Java Crash, Native Crash, and ANR.
3. Fixed the issue of frequent session_id updates in long sessions with no action updates.

1.5.0 (2024/06/03)¶

1. Added remote IP address resolution for RUM resource network requests.
2. Fixed array thread safety issues caused by high-concurrency network requests when RUM SampleRate is enabled.
3. Optimized fault tolerance for the ConnectivityManager.registerDefaultNetworkCallback method.
4. Added Integer data compatibility mode for line protocol to handle web data type conflicts.
5. Optimized resource name ID retrieval for controls in automatically collected Action clicks.
6. Optimized fault tolerance for SDK config reading exceptions.

1.4.6 (2024/05/15)¶

1. Optimized SDK initialization fault tolerance.
2. Added Status.Debug type to logs.
3. Adjusted console log level mappings: Log.i -> info, Log.d -> debug.
4. Supported custom status fields in FTLogger custom logs.

1.4.5 (2024/04/26)¶

1. Optimized compatibility for repeated initialization.
2. Optimized c/c++ crash data synchronization logic to avoid deadlocks in scenarios where unexpected exits occur.
3. Optimized startAction Property attribute writing logic to avoid thread safety issues.

1.4.4 (2024/04/01)¶

1. Added database connection fault tolerance protection.
2. Fixed the issue where child process configurations were ineffective when setOnlySupportMainProcess was true.
3. Fixed the issue where Crash would not rethrow when RUM View collection was not enabled.

1.4.3 (2024/03/22)¶

1. Supported uploading Dataway and Datakit addresses.
2. Supported sending RUM data of types Action, View, Resource, LongTask, and Error.
   • View and Action page navigation and control click actions are automatically collected using ft-plugin.
   • Resource is automatically collected, supporting only OkHttp and requiring ft-plugin.
   • Native Crash and ANR in Error require ft-native.
3. Supported sending Log data, with automatic console writing requiring ft-plugin.
4. Supported HTTP header propagation for traces, supporting only OkHttp and requiring ft-plugin.
5. Supported configuring data synchronization parameters, request entry count, synchronization interval, and log cache entry count.
6. Supported converting SDK internal logs to files.

More logs

ft-native¶

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 for Native Crash and ANR.

1.1.0 (2024/03/22)¶

1. Supported capturing ANR Crash.
2. Supported capturing C/C++ Native Crash.
3. Supported capturing application runtime status during crashes.
4. Supported callbacks triggered by ANR and Native Crash.

More logs

ft-plugin ( AGP >=7.4.2 )¶

1.3.5 (2025/04/18)¶

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

1.3.4 (2024/12/11)¶

1. Optimized error log output.
2. Fixed the issue where sourcemap symbol files were not generated when minifyEnabled was not enabled.
3. Supported generating sourcemap without automatic upload by setting generateSourceMapOnly to true.

1.3.3 (2024/09/04)¶

1. Optimized automatic upload of native symbol so, supporting custom nativeLibPath specification.

1.3.2 (2024/08/13)¶

1. Supported automatic capture of React Native WebView events.

1.3.1 (2024/07/04)¶

1. Added asmVersion configuration, supporting asm7 to asm9, defaulting to asm9.
2. Fixed the issue where custom WebView methods caused loop calls after ASM writing, preventing WebView content loading (involving methods loadUrl, loadData, loadDataWithBaseURL, postUrl).
3. IgnoreAOP supported class-level declarations for method ignoring.
4. Added ignorePackages configuration to support ASM ignoring by package path.

1.3.0 (2024/03/22)¶

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

More logs

ft-plugin-legacy ( AGP <=7.4.2 )¶

1.1.8 (2024/08/13)¶

1. Supported automatic capture of React Native WebView events.

1.1.7 (2024/07/04)¶

1. Fixed the issue where subclass overrides of WebView methods caused loop calls after ASM writing, preventing WebView content loading (involving methods loadUrl, loadData, loadDataWithBaseURL, postUrl).
2. IgnoreAOP supported class-level declarations for method ignoring.
3. Added ignorePackages configuration to support ASM ignoring by package path.

1.1.6 (2024/03/22)¶

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

More logs