Changelog¶

ft-sdk¶

1.6.16 (2026/1/08)¶

1. Added illegal character filtering for globalContext and attribute keys.
2. Extended resource_type support range, added new types: image, media, font, CSS, JS, native.
3. Added support for custom parsing and configuration of remote variables via FTSDKConfig.setRemoteConfigurationCallBack(FTRemoteConfigManager.FetchResult),FTSdk.updateRemoteConfig(int remoteConfigMiniUpdateInterval, FTRemoteConfigManager.FetchResult result).
4. Added resource_http_protocol, resource_request_size, resource_connection_reuse fields to Resource.
5. Refined cold start time metrics, added app_pre_application_init_time, app_application_init_time and app_first_frame_init_time.
6. Added compatibility support for OkHttp 3.12 and above.
7. Fixed inaccurate Resource request start time.
8. Fixed occasional null pointer exceptions when obtaining Action and View during SDK shutdown.
9. Optimized error stack format, fixed 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 consumption 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 enters the background.
2. Optimized the output mechanism for long logs exceeding 4K, improving log readability and integrity.
3. Optimized the generation logic of resource, long task, error in the View context.
4. Increased View generation rate and reduced traffic data generated with the same view_id.
5. Removed the restriction on ActivityLifecycleCallbacks in child processes for more complete lifecycle monitoring.
6. Fixed occasional View data update loss.
7. Fixed session refresh exceptions caused by asynchronous network requests.
8. Fixed the 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 the declaration of android.permission.READ_PHONE_STATE from the SDK AndroidManifest. Integrators need to add it themselves based on actual conditions. Permission usage instructions are in the Integration Documentation.
3. Limited 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 start, 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 page tracking is handled 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 page tracking is handled in RUM data. Developers can modify page names, add custom attributes, or skip tracking specific Fragments.
4. Fixed the issue where FTRUMGlobalManager.addAction lacked bindUserData binding related information, such as userid.
5. View Fragemnt load_time data metric.
6. Added FTRUMGlobalManager.updateTime to customize the current view's loading 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 the Android SDK. Use FTRUMConfig.setAllowWebViewHost to control which host addresses to filter.
2. Added ContentHandlerHelperEx.onExceptionWithFilter to filter local network errors.
3. Added FTSDKConfig.setRemoteConfiguration to support enabling remote conditional configuration functionality. 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, it can sample RUM data from 1 minute ago when an error occurs.
4. When FTSDKConfig.setEnableAccessAndroidID(false), use a local random uuid as device_uuid.
5. Optimized high-frequency log writing, data synchronization, and data idle shutdown logic.

1.6.10 (2025/04/18)¶

1. Added FTSDKConfig.setEnableOkhttpRequestTag to support adding unique ResourceID to okhttp requests, to solve the issue of trace_id and span_id misalignment in high concurrency scenarios for identical requests. ft-plugin version 1.3.5 and above supports automatic ResourceID addition.
2. Fixed the issue of recursive calls caused by multiple RUM configuration initializations with other crash collection SDKs.
3. When navigating from a native page to a WebView page, use the native page name to fill view_referrer.
4. Fixed the issue where re-throwing IOException from network requests altered the original type.
5. FTSDKConfig added setProxy, setProxyAuthenticator, setDns to configure Proxy, ProxyAuthenticator, Dns for OkHttp data synchronization network requests.
6. OkHttp data synchronization network requests support known hostName DNS IP round-robin connections.

1.6.9 (2025/03/07)¶

1. Modified the 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 display of Resource time consumption on Guance and aligns with the timeline in the APM flame graph.
3. Optimized synchronization retry mechanism, removed the configuration option FTSDKConfig.setDataSyncRetryCount(0) for immediate data discard.
4. FTSDKConfig.enableDataIntegerCompatible is enabled by default for compatibility with web numeric floating-point types.
5. Fixed the issue of duplicate crash data generation in scenarios with multiple RUM configuration initializations.

1.6.8 (2025/01/21)¶

1. Fixed inaccurate fps collection when initializing RUM configuration 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 custom FTTraceInterceptor.HeaderHandler to correlate with RUM data.
2. Support modifying the content of the ASM-written FTTraceInterceptor.HeaderHandler via FTRUMConfig.setOkHttpTraceHeaderHandler, and support modifying the content of the ASM-written FTResourceInterceptor.ContentHandlerHelper via FTRUMConfig.setOkHttpResourceContentHandler.
3. Optimized crash collection capability, adapted to scenarios where system.exit triggered by certain OS prevents crash data collection.
4. Fixed the occasional issue where the tag was an empty string, causing data upload failure.
5. Optimized the ASM OkHttpListener EventListener coverage logic, supporting the retention of original project EventListener event parameter passing.

1.6.6 (2024/12/27)¶

1. Optimized network status and type acquisition, added support for displaying ethernet network type.
2. Optimized the issue of frequent database closures when writing data without network connection.
3. Fixed the discrepancy between the number of discarded log/RUM old data entries and the set number.
4. Adapted TV device button events, removed non-TV device tags.
5. Support limiting the upper limit of RUM data cache entries via FTRUMConfig.setRumCacheLimitCount(int), default is 100_000.
6. Support 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 the prompt for null parameters during AOP for Webview.
2. Optimized the 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 setting the detection time range via FTRUMConfig.setEnableTrackAppUIBlock(true, blockDurationMs).

1.6.3 (2024/11/18)¶

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

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 the issue where calling custom startView separately in RUM caused the monitoring metric FTMetricsMTR thread not to be recycled.
2. Support adding dynamic attributes via FTSdk.appendGlobalContext(globalContext), FTSdk.appendRUMGlobalContext(globalContext), FTSdk.appendLogGlobalContext(globalContext).
3. Support clearing unsynced 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 old versions to 1.6.0 requires configuring FTSDKConfig.setNeedTransformOldCache for old data compatibility synchronization.)
2. Fixed the issue where calling Log.w(String,Throwable) caused an exception when using ft-plugin.

1.5.2 (2024/07/10)¶

1. Error network_error added prompts for local network error types to supplement scenarios where resource_status=0 in Resource data.
2. Fixed the uncaughtException rethrow delivery issue when setEnableTrackAppCrash(false).

1.5.1 (2024/06/19)¶

1. Java Crash and ANR supplemented with code stacks from other threads.
2. Java Crash, Native Crash, ANR added additional logcat configuration functionality.
3. Fixed the issue of frequent session_id updates during long sessions with no action updates.

1.5.0 (2024/06/03)¶

1. RUM resource network requests added remote ip address resolution functionality.
2. Fixed array thread safety issues caused by high concurrency network requests after enabling RUM SampleRate.
3. Fault tolerance optimization for the 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 captured log level correspondence: Log.i -> info, Log.d -> debug.
4. FTLogger custom logs support custom status field.

1.4.5 (2024/04/26)¶

1. Repeated initialization compatibility optimization.
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 the issue where part of the configuration did not take effect in child processes 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. Support uploading addresses for Dataway and Datakit.
2. Support sending RUM data of types Action, View, Resource, LongTask, Error.
   • Automatic collection of View, Action page navigation, control clicks requires ft-plugin.
   • Automatic Resource collection only supports Okhttp and requires ft-plugin.
   • Native Crash and ANR in Error require ft-native.
3. Support sending Log data, automatic console writing requires ft-plugin.
4. Trace http header propagation only supports Okhttp and requires ft-plugin.
5. Support data synchronization parameter configuration: request entry data, synchronization interval time, and log cache entry count.
6. Support converting internal SDK 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 functionality for Native Crash and ANR.

1.1.0 (2024/03/22)¶

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

More logs

ft-plguin ( AGP >=7.4.2 )¶

1.3.6 (2025/12/03)¶

1. Support UniApp WebView.
2. Added knownWebViewClasses parameter to support ASM writing.
3. Added functionality to output logs to files.
4. Added verboseLog parameter for more 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 the stability of plugin parameters in concurrent compilation.
2. Added ASM writing of FTAutoTrack.trackRequestBuilder method, requires ft-sdk version 1.6.10 or above.
3. Support 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 the issue where sourcemap symbol files were not generated when minifyEnabled was not enabled.
3. Support generating sourcemap but not actively uploading it via generateSourceMapOnly true.

1.3.3 (2024/09/04)¶

1. Optimized automatic acquisition and upload of native symbol so, support custom specified nativeLibPath.

1.3.2 (2024/08/13)¶

1. Support automatic capture of React Native WebView events.

1.3.1 (2024/07/04)¶

1. Added asmVersion configuration functionality, supporting asm7 - asm9, default is asm9.
2. Fixed the issue where custom WebView methods caused recursive calls after ASM writing, preventing WebView content from loading (involving methods loadUrl, loadData, loadDataWithBaseURL, postUrl).
3. IgnoreAOP supports declaration within a class to ignore all methods in the entire class.
4. Added ignorePackages configuration to support ignoring ASM by package path.

1.3.0 (2024/03/22)¶

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

More logs

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

1.1.9 (2025/12/09)¶

1. Support UniApp WebView.
2. Added knownWebViewClasses parameter to support ASM writing.
3. Added functionality to output logs to files.
4. Added verboseLog parameter for more 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. Support automatic capture of React Native WebView events.

1.1.7 (2024/07/04)¶

1. Fixed the issue where overriding methods in WebView subclasses caused recursive calls after ASM writing, preventing WebView content from loading (involving methods loadUrl, loadData, loadDataWithBaseURL, postUrl).
2. IgnoreAOP supports declaration within a class to ignore all methods in the entire class.
3. Added ignorePackages configuration to support ignoring ASM by package path.

1.1.6 (2024/03/22)¶

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

More logs