Changelog¶

1.5.21 (2026/04/16)¶

1. Added setDatakitURL: and setDatawayURL:clientToken: methods to support dynamic endpoint updates at runtime.
2. Minimum deployment target adjusted to iOS 12+, macOS 10.14+.
3. Fixed an issue where View association failed when calling addAction:.
4. Optimized Log and RUM association logic, added missing action_id field.
5. Fixed RemoteConfig fetch interval logic; SDK now uses the local last request time for interval validation on startup.
6. Fixed an issue where dynamic modification of sampling rate did not take effect.

1.5.20 (2026/02/26)¶

1. Fixed concurrency read-write issues in FTPresetProperty, preventing crashes caused by dictionary corruption and double release.
2. Enabled WAL mode for SQLite within the SDK.
3. Replaced deprecated SCNetworkReachability with NWPathMonitor.
4. Removed usage of deprecated API UIScreen.mainScreen.
5. Fixed the processing logic for FTMobileConfig.dataModifier to ensure it covers all data entries.

1.5.19 (2026/01/09)¶

1. Extended resource_type, added new types: image, media, font, CSS, JS, native.
2. Added resource_id to network errors for associating with corresponding resource data.
3. Support for custom parsing and configuration of remote variables via callback in FTMobileConfig.remoteConfigFetchCompletionBlock or +updateRemoteConfigWithMiniUpdateInterval:completion: method.
4. Added resource_http_protocol, resource_request_size, resource_connection_reuse fields to Resource.
5. Refined cold start and warm start time metrics, added app_pre_runtime_init_time, app_runtime_init_time, app_uikit_init_time, app_application_init_time, and app_first_frame_init_time.
6. Fixed data loss issue caused by missing RUM View.
7. Enhanced crash and ANR stack trace capabilities, supporting full thread information collection, and allowing crash monitoring type configuration via FTRumConfig.crashMonitoring.

1.5.18 (2025/08/08)¶

1. Added support for RUM View/Action collection filtering and custom View/Action naming via FTRumConfig.viewTrackingHandler and FTRumConfig.actionTrackingHandler.
2. Added method -updateViewLoadingTime: to update loading time for the currently active RUM View.
3. Fixed missing sdk_name field in log data.
4. Fixed UserScripts conflict issue in WebView data collection.
5. Fixed thread safety issue with SDK shutdown operation.
6. Fixed crash caused by modifying the main thread's name during Long task monitoring.
7. Added FTRumConfig.h/.m files, splitting FTRumConfig into a separate file from FTMobileConfig.h.

1.5.17 (2025/06/11)¶

1. Added FTRUMConfig.enableTraceWebView to configure whether to enable WebView data collection via SDK. FTRUMConfig.allowWebViewHost can be used to control host address filtering.
2. Added FTRumConfig.sessionTaskErrorFilter to filter local network errors.
3. Added FTMobileConfig.remoteConfiguration to enable remote conditional configuration feature, and FTMobileConfig.remoteConfigMiniUpdateInterval to set the minimum update interval after enabling remote control.

1.5.16 (2025/05/16)¶

1. Added FTMobileConfig.lineDataModifier and FTMobileConfig.dataModifier to support data write replacement and data masking.
2. Added FTRUMConfig.sessionErrorSampleRate to support error sampling. When not sampled by sampleRate, it can sample RUM data from one minute prior when an error occurs.
3. Logger supports setting custom log level filtering via logLevelFilter.
4. When navigating from a native page to a WebView page, the native page name is used to populate view_referrer.

1.5.15 (2025/04/14)¶

1. Fixed Swift Package Manager compilation error.

1.5.14 (2025/03/07)¶

1. 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 Resource duration display on Guance and aligns with the timeline in the "APM" flame graph.
2. Enabled FTMobileConfig.enableDataIntegerCompatible by default.
3. Added support for disabling URLSession Method Swizzling within the SDK via macro definition FT_DISABLE_SWIZZLING_RESOURCE.
4. Optimized data synchronization, added retry logic for failures.

1.5.13 (2025/02/27)¶

1. Optimized page collection logic to prevent missing RUM View collection due to special views.

1.5.12 (2025/02/10)¶

1. Adjusted file storage path configuration, fixed database creation failure issue in tvOS environment.
2. Updated default service and log source for tvOS environment to df_rum_tvos and df_rum_tvos_log respectively.
3. Fixed inaccurate duration calculation in RUM Action events.

1.5.11 (2025/02/05)¶

1. Optimized RUM Resource collection to prevent SDK internal requests from being collected when RUM Resource auto-collection is enabled.
2. Fixed skyWalking type trace failure issue in Widget Extension.

1.5.10 (2025/01/21)¶

1. Support for intercepting Request for custom Trace via FTTraceConfig.traceInterceptor, and adding custom properties to RUM Resource via FTRumConfig.resourcePropertyProvider.
2. Fixed abnormal behavior of dynamic global property addition method under multi-threaded access.
3. Optimized data information passed to WebView.

1.5.9 (2025/01/08)¶

1. Added support for intercepting URLRequest via FTURLSessionDelegate.traceInterceptor block for custom trace, modifying spanId and traceId within the trace.
2. RUM Resource now supports collecting network requests initiated via swift async/await URLSession API.
3. Fixed View association error for LongTask and Anr.

1.5.8 (2024/12/23)¶

1. Added tvOS support.
2. Support for limiting maximum RUM cache entry count via FTRUMConfig.rumCacheLimitCount, and setting discard policy via FTRUMConfig.rumDiscardType.
3. Support for limiting total cache size via FTMobileConfig.enableLimitWithDbSize. Once enabled, FTLoggerConfig.logCacheLimitCount and FTRUMConfig.rumCacheLimitCount become invalid. Support for setting db discard policy via FTMobileConfig.dbDiscardType and db cache size limit via FTMobileConfig.dbCacheLimit.

1.5.7 (2024/12/04)¶

1. Support for setting freeze detection threshold via FTRUMConfig.freezeDurationMs.
2. Optimized SDK's shutDown method to avoid lag or WatchDog crash caused by synchronous waiting on the main thread.

1.5.6 (2024/11/13)¶

1. Support for deflate compression configuration on synchronous data using FTMobileConfig.compressIntakeRequests.
2. RUM added addAction:actionType:property and startAction:actionType:property: methods, optimizing RUM Action collection logic.
3. Fixed crash issue caused by using deprecated NSFileHandle API.

1.5.5 (2024/11/06)¶

1. Fixed crash caused by array out-of-bounds in FTResourceMetricsModel.

1.5.4 (2024/10/18)¶

1. Added dynamic setting methods for global, log, and RUM globalContext properties.
2. Added data clearing method to delete all data not yet uploaded to the server.
3. Adjusted maximum supported sync interval to 5000 milliseconds.

1.5.3 (2024/10/09)¶

1. Fixed memory access error crash in LongTask and Anr collection caused by incorrect property modifier usage.
2. Replaced method signature validation assertion in FTSwizzler with internal warning logs.
3. Optimized decimal precision of collected data.

1.5.2 (2024/08/21)¶

1. Fixed missing #include <arm/_mcontext.h> header file issue when compiling with Xcode 16.
2. When auto-collecting RUM-Resource, filters out Resources fetched directly from local cache or with unknown fetch type to prevent duplicate collection.
3. Fixed UITabBarController subview loadingTime calculation logic.

1.5.1 (2024/08/02)¶

1. Fixed line protocol data escaping algorithm, resolving data sync failure caused by newline characters.
2. Optimized error messages for error type network_error, uniformly using English descriptions for network request error codes.
3. Optimized data sync logic, fixed crash caused by multi-threaded access to released uploadDelayTimer.
4. Fixed crash during crash information collection caused by encoding format error when converting between OC and C strings.

1.5.0 (2024/06/03)¶

1. Added remote IP address resolution for RUM resource network requests.
2. Added line protocol Integer data compatibility mode to handle web data type conflicts.
3. Added custom status method for logs.
4. Optimized log data writing and data synchronization.
5. Format processing for NSDictionary type parameters passed to SDK to prevent data loss due to JSON conversion failure.

1.4.14 (2024/05/29)¶

1. Fixed memory access error crash in FTSwizzler caused by accessing destroyed Class objects.
2. Fixed potential data consistency and operation conflict issues when NSDictionary type parameters passed to SDK were actually mutable objects.

1.4.13 (2024/05/15)¶

1. Optimized RUM LongTask and Anr collection, fixed inaccurate LongTask stack trace collection, added support for collecting fatal freezes.
2. Fixed crash in FTSwizzler caused by concurrent multi-threaded operations on NSMutableSet.
3. Fixed missing version information in SDK Framework info.plist during packaging.
4. Fixed performance metric collection failure for Resource when custom NSURLSession delegate is not set.
5. Optimized SDK internal log to file conversion feature, added method to specify file path.

1.4.12 (2024/04/26)¶

1. Fixed memory leak issue caused by calling SDK shutdown method shutDown.
2. Fixed crash caused by conflict with other libraries when collecting RUM-Resource.
3. Fixed issue where UncaughtExceptionHandler was not passed during crash collection.
4. Fixed data anomalies caused by multiple SDK initializations.

1.4.11(2024/03/28)¶

1. Added support for configuring data sync parameters: request entry count, sync interval time, and log cache entry count.
2. Added internal log to file method.
3. Fixed error in log association with RUM data retrieval.
4. Optimized time-consuming operations.
5. Fixed crash during WebView jsBridge, changed WebView reference to weak reference.

More logs