# RUM iOS SDK release notes Jun 16, 2026 iOS SDK 2.9.1 - Fixed Cold Start AVG reporting multi-hour values. Prewarmed launches (iOS spawns the process in the background ahead of user intent, flagged by `ActivePrewarm`) and other background launches (push/fetch/location) were measured from kernel process birth time and counted as cold starts. Prewarmed launches are now skipped, and any cold-start duration beyond a 60s ceiling is dropped as a background-launch artifact. **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/mobile-performance/index.md)** Jun 15, 2026 iOS SDK 2.9.0 - Session Replay now emits a one-shot init log capturing its configuration when recording starts, so the active Session Replay settings are visible in the backend. **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/session-replay/ios/index.md)** Jun 11, 2026 iOS SDK 2.8.0 - Fixed SwiftUI text and images not being masked in session replay, where the synchronous UIView walk could not see inside SwiftUI hosting views (BUGV2-6045). As an interim fix, the Vision-based `TextScanner` (OCR) and `ImageScanner` `maskAll` (rectangle detection) pipeline stages are restored, scoped to captures whose scene contains a SwiftUI hosting view (`URLEntry.containsSwiftUIContent`). UIKit and Flutter capture paths are unchanged. OCR masking is probabilistic (for example, rows clipped at the viewport edge mid-scroll may escape recognition). - Fixed a session replay mask-skew bug where, during scroll animations, mask rects drifted 16–80+ px behind the text they covered (BUGV2-6045). Native-window capture now uses `layer.render(in:)` (the model layer) and collects mask rects synchronously in the same render pass. - Fixed Flutter content appearing as a transparent hole in session-replay frames. A new `flutterViewBitmapProvider` requests a pre-masked RGBA8888 bitmap from the Flutter plugin's Dart rasteriser, which captures and masks in a single synchronous frame slice. - Fixed the session replay capture timer silently never firing when initialised via Flutter's background MethodChannel task queue (background threads have no run loop). All `SessionReplay` entry points now dispatch to `DispatchQueue.main`. - Fixed session replay click frames not being detected on iOS 26: `getClickPoint` cast tap coordinates with `as? Double`, which no longer succeeds for a boxed `CGFloat` on iOS 26. Coordinates are now coerced from any numeric boxing (`Double`/`CGFloat`/`Int`/`NSNumber`). - Added `SessionReplayOptions.flutterViewBitmapProvider: FlutterViewBitmapProvider?`, a callback for Flutter hosts to supply pre-masked frame bitmaps per capture. **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/session-replay/ios/index.md)** Jun 2, 2026 iOS SDK 2.7.0 - Added a `customAttributes: [String: Any]?` parameter on the `reportError(message:, stackTrace:, ...)` and `reportError(message:, obfuscatedStackTrace:, ...)` overloads. Custom attributes now ride alongside the parsed stack frames on the emitted error event instead of being mutually exclusive with the stack trace (CX-44438). May 12, 2026 iOS SDK 2.6.4 - The hybrid SDK path now honors `excludeFromSampling` (CX-40203). May 11, 2026 iOS SDK 2.6.3 - Added the `ExcludableInstrumentation` enum and the `excludeFromSampling` SDK option (CX-40199). - Added per-session sampling reroll with init-flow decoupling (CX-40200). - Added a per-span sampling filter in `CoralogixExporter` (CX-40201). - Added SwiftUI swipe detection (CX-33282). - Fixed Session Replay scroll lag. **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/session-replay/ios/index.md)** Apr 28, 2026 iOS SDK 2.6.2 - Fixed a Flutter scroll freeze by using `afterScreenUpdates: false`. Apr 26, 2026 iOS SDK 2.6.1 - Fixed the `tracesExporter` `instrumentation_data` payload and the `TracesExporterViewController` per-span table UI. **[Learn more](https://coralogix.com/docs/user-guides/rum/sdk-features/trace-exporter/index.md)** Apr 23, 2026 iOS SDK 2.6.0 - Hardened the Custom Spans API and fixed a network span 422 error (CX-39134). **[Learn more](https://coralogix.com/docs/user-guides/rum/sdk-features/custom-spans/index.md)** Apr 16, 2026 iOS SDK 2.5.1 - Removed all `assert`/`precondition`/`fatalError` calls from SDK code, so the SDK can no longer crash the host app (CX-37986). - Added a global span registry (CX-37986). Apr 14, 2026 iOS SDK 2.5.0 - Added the Traces Exporter (OTLP JSON) with a callback. **[Learn more](https://coralogix.com/docs/user-guides/rum/sdk-features/trace-exporter/index.md)** - Added global span trace propagation and `ignoredInstruments` for automatic spans (CX-35954/CX-35955). - Added the Custom Spans API, OTel context, and RUM/Tracing parity with the Browser SDK (CX-35951). **[Learn more](https://coralogix.com/docs/user-guides/rum/sdk-features/custom-spans/index.md)** - Added the `US3` domain to the `CoralogixDomain` enum. - Fixed preservation of `telemetry.sdk.*` attributes in the OTel Resource. Mar 29, 2026 iOS SDK 2.4.1 - Fixed `traceparent` header capture in the React Native / Flutter hybrid network path. Mar 26, 2026 iOS SDK 2.4.0 - Added Flutter obfuscated errors plus error metadata (`arch`, `build_id`, `stack_trace_type`). Mar 22, 2026 iOS SDK 2.3.3 - Forward request and response headers and payload in the Flutter hybrid network path. Mar 22, 2026 iOS SDK 2.3.2 - Made `Span` conform to `Equatable` and record events conform to `Hashable`. Mar 22, 2026 iOS SDK 2.3.1 - Made `Span` conform to `Hashable`. Mar 18, 2026 iOS SDK 2.3.0 - Added request/response body capture, a hybrid severity fix, and tap x/y rounding (CX-33235). - Added response body capture with content-type stringification and a 1024-char limit (CX-33234). - Unified `beforeSendCallBack` behavior across SDKs (CX-32889). - Fixed React Native response body capture plus `URLSession` race conditions. - Fixed the `beforeSend` error count when severity changes (BUGV2-5379). - Preserve the request in `requestMap` for network header capture, and moved `SDKSampler`. Mar 9, 2026 iOS SDK 2.2.0 - Added hybrid platform support for `setUserInteraction`, `setNetworkRequestContext`, and session-replay decoupling. - Enriched `instrumentation_data.otelSpan` with `cx_rum.*` structured attributes. - Added the `NetworkCaptureRule` model and the `networkExtraConfig` SDK option (CX-33230). - Added capture-rule fields on `NetworkRequestContext` (CX-33232). - Added the `resolveConfigForUrl(_:configs:)` API (CX-33231). - Added `shouldSendText` and `resolveTargetName` delegates for user-action events (CX-32583). - Added `UISwipeGestureRecognizer` swipe detection (CX-32582). - Extended the interaction schema with scroll detection and PII-safe text (CX-32580/CX-32581). - Process MetricKit hang diagnostics as error events (CX-31668). - Allow clearing user context by passing `nil` to `setUserContext`. - Decoupled ANR from Mobile Vitals and report it as error events. - Removed unused mobile-vitals sample-rate configuration (CX-31659). - Fixed accurate cold-start measurement via `sysctl` and removed the swizzle dependency (CX-31662). - Report warm start for Flutter and React Native apps (CX-31661). - Include zero-count windows in frame statistics for accurate percentiles (CX-31666). - Removed the 100% cap from memory utilization (CX-31664). - Removed the CPU 100% cap to detect multi-core saturation (CX-31663). **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/mobile-performance/index.md)** Feb 12, 2026 iOS SDK 2.1.0 - Eliminated delegate class scanning and migrated to industry-standard swizzling for multi-SDK compatibility. Feb 5, 2026 iOS SDK 2.0.0 - Added Flutter session-recording masking support. - Fixed severity syncing from the `beforeSend` callback to `CxSpan`. Jan 21, 2026 iOS SDK 1.5.3 - Fixed a negative-duration bug and now mark the session ID and session creation date correctly (CX-4620). Jan 5, 2026 iOS SDK 1.5.2 - Wired ANR detection into the scheme (CX-26496). Dec 23, 2025 iOS SDK 1.5.1 - Adopted `async`/`await` in internal APIs (CX-25861). Dec 3, 2025 iOS SDK 1.5.0 - Added a masking bridge widget (ALPH-22252). **[Learn more](https://coralogix.com/docs/user-guides/rum/sdk-features/data-masking/index.md)** Nov 9, 2025 iOS SDK 1.4.0 - Added an iOS mask-view for the native SDK (ALPH-15201). **[Learn more](https://coralogix.com/docs/user-guides/rum/sdk-features/data-masking/index.md)** Nov 3, 2025 iOS SDK 1.3.2 - Fixed a missing session-replay function (ALPH-1234). **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/session-replay/ios/index.md)** Oct 30, 2025 iOS SDK 1.3.1 - Fixed a session-replay segment-index bug (ALPH-1234). **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/session-replay/ios/index.md)** Oct 26, 2025 iOS SDK 1.3.0 - Added a screenshot change-detection filter for iOS Session Replay (ALPH-2515). **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/session-replay/ios/index.md)** - Added mobile-vitals options (ALPH-2754). **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/mobile-performance/index.md)** Sep 28, 2025 iOS SDK 1.2.6 - Emit Navigation events (ALPH-2546). - Added a Custom-measurement API. **[Learn more](https://coralogix.com/docs/user-guides/rum/sdk-features/custom-measurements/index.md)** - Added custom log labels (ALPH-2257). - Send an internal-init event (ALPH-2654). - Refactored mobile vitals (ALPH-2704). - Session reset now uses a closure instead of `NotificationCenter`. - Fixed an idle bug. Sep 4, 2025 iOS SDK 1.2.5 - Automated the CocoaPods release pipeline (ALPH-6671). Sep 1, 2025 iOS SDK 1.2.3 - Bumped the `PLCrashReporter` dependency. Aug 31, 2025 iOS SDK 1.2.2 - Fixed the user-agent string. - React Native integration fixes (ALPH-1234). Aug 26, 2025 iOS SDK 1.2.1 - Fixed broken `spanid` and `traceid`. - Fixed an app freeze on the main thread. Aug 25, 2025 iOS SDK 1.2.0 - Added persistent anonymous fingerprinting (ALPH-2644). - Added a unified Mobile Vitals reporting API. - Added slow / freeze frame detection (ALPH-2588). - Added a memory detector (ALPH-2550). - Added native iOS CPU tracking (ALPH-2579). - Added missing metrics and logic (ALPH-1234). **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/mobile-performance/index.md)** Aug 11, 2025 iOS SDK 1.1.3 - Fixed an app crash in `NSMutableURLRequest` ObjC bridging (ALPH-2631). Jul 30, 2025 iOS SDK 1.1.2 - Externalized `PLCrashReporter` from the main RUM module (ALPH-2488). - Fixed iOS schema issues (ALPH-2530). - Removed duplicate swizzle code that sent multiple clicks. - `sessionId` is now lowercase (ALPH-2523). - `ignoreUrl` now works with regex (ALPH-2519). - Fixed a `URLSession` instrumentation deadlock. - Fixed a crash in `URLSessionInstrumentation.injectIntoNSURLSessionCreateTaskWithParameterMethod` (ALPH-2507). Jul 17, 2025 iOS SDK 1.1.1 - Fixed several crashes (ALPH-2498). Jul 10, 2025 iOS SDK 1.1.0 - Refactored the idle logic (ALPH-2468). Jul 2, 2025 iOS SDK 1.0.27 - Added an `isManual` flag (ALPH-2429). - Added snapshot context on all severity-5 events (ALPH-2424). - Fixed a crash in the `BatchWorker` / `NetworkStatus` class (ALPH-2423). Jun 26, 2025 iOS SDK 1.0.26 - Added `traceparent` header injection (native) (ALPH-2296). - When using a proxy URL, the exporter now removes the span correctly (ALPH-2148). Jun 24, 2025 iOS SDK 1.0.25 - Added a `traceparent` header option on `CoralogixOptions` (ALPH-2295). - Added proxy URL support (native) (ALPH-2292). - Fixed a crash in `SessionMetaDataManager` (ALPH-2914). Jun 22, 2025 iOS SDK 1.0.24 - Changed duration handling, added undefined-text handling, and repaired broken tests (ALPH-2388). - Fixed images being skipped during session recording (ALPH-2360). **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/session-replay/ios/index.md)** Jun 5, 2025 iOS SDK 1.0.23 - Added Flutter support for cold / warm mobile vitals (ALPH-1234). - Initialize `segmentIndex` when the page is incremented (ALPH-2286). May 25, 2025 iOS SDK 1.0.22 - Added Session Replay click events (ALPH-1885). - Added a disable-swizzling option (ALPH-2246). **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/session-replay/ios/index.md)** May 8, 2025 iOS SDK 1.0.21 - Added screenshot events in session recording (ALPH-2159). - Fixed a crash in `URLSessionInstrumentation` (ALPH-2218). **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/session-replay/ios/index.md)** Apr 24, 2025 iOS SDK 1.0.20 - Merged Session Replay into the main module (ALPH-2183). - Fixed a crash in `URLSession` instrumentation (ALPH-2195). **[Learn more](https://coralogix.com/docs/user-guides/rum/product-features/session-replay/ios/index.md)** Apr 14, 2025 iOS SDK 1.0.19 - Added `beforeSend` logic. Apr 3, 2025 iOS SDK 1.0.18 - Rolled back OpenTelemetry to 1.9.0 (ALPH-2154). - Fixed a DANZ duration bug — durations are now in milliseconds (ALPH-2151). - Fixed a crash in the "xploretechnologey" path (ALPH-2148). Mar 27, 2025 iOS SDK 1.0.17 - Fixed `ignoreUrl` and `ignoreError` API behavior. Mar 16, 2025 iOS SDK 1.0.16 - Added missing API functions (ALPH-2128). - Fixed network requests not being captured in some cases (ALPH-2128). Mar 6, 2025 iOS SDK 1.0.15 - Added new public API functions (ALPH-2214). Feb 24, 2025 iOS SDK 1.0.14 - Switched the library to static linkage. Feb 4, 2025 iOS SDK 1.0.13 - Fixed a crash in the `UICollectionView` swizzle. Nov 19, 2024 iOS SDK 1.0.12 - Added lifecycle events (ALPH-1623). - Added daily metrics log reporting (ALPH-1625). - Added `beforeSend` logic (ALPH-1622). - Added instrumentation config (ALPH-1567). - Added AP3 environment support. - Added performance mobile vitals (ALPH-1463). - Skip collecting IP data (ALPH-1570). - Fixed a Flutter gap, lifecycle bugs, and a Flutter stuck-trace bug (ALPH-1759). Aug 28, 2024 iOS SDK 1.0.11 - Fixed iOS 13 compatibility (Xcode 15.0.1). Aug 27, 2024 iOS SDK 1.0.10 - Added basic tvOS support (ALPH-1506). - Added a `samplerRate` option on `CoralogixOptions`. - Added RUM user actions (ALPH-1285). - Added traces support (ALPH-1375). - Flatten error context. - Fixed a wrong Swift tools version — now 5.9. - Fixed telephony info handling. Jul 7, 2024 iOS SDK 1.0.8 - Added native enhancements for Flutter capabilities (ALPH-1137). Jun 23, 2024 iOS SDK 1.0.6 - Added the CocoaPods podspec. Jun 20, 2024 iOS SDK 1.0.5 - Added OpenTelemetry API/SDK and `PLCrashReporter` as XCFrameworks. - Added session-snapshot logic (ALPH-1187). - Added OpenTelemetry SDK/API integration (ALPH-1187). May 26, 2024 iOS SDK 1.0.4 - Added ViewController extraction for Swift UIKit. - Added ViewController extraction for SwiftUI (ALPH-1085). - Added `DeviceState` and `DeviceContext` (ALPH-1112). May 2, 2024 iOS SDK 1.0.0 - Initial release of the Coralogix iOS RUM SDK.