Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fdocs-docusaurus.kinsta.page%2Fuser-guides%2Frum%2Fsdk-installation%2Fapple%2Frelease-notes.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs-docusaurus.kinsta.page%2Fuser-guides%2Frum%2Fsdk-installation%2Fapple%2Frelease-notes.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.) # RUM iOS SDK changelog Jun 24, 2026 iOS SDK 2.9.2 * On the hybrid (React Native / Flutter) path, a `beforeSend` edit to an editable `cx_rum` field (for example, redacting `session_context.user_email` or rewriting `labels`) was reflected in `text.cx_rum` but not in `instrumentation_data.otelSpan.attributes`: the encoded spans were uploaded verbatim after the callback, so the tracing mirror stayed stale and a redacted value still leaked through tracing. The OTEL attributes are now rebuilt from the edited `cx_rum` before upload — the same rebuild the native single-event path performs — so both destinations carry identical values. Jun 16, 2026 iOS SDK 2.9.1 [![mobile-performance-hero](/assets/images/hero-ae701411e123f6f1658f5c199ca3f3e6.webp)](https://docs-docusaurus.kinsta.page/assets/images/hero-ae701411e123f6f1658f5c199ca3f3e6.webp) 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://docs-docusaurus.kinsta.page/user-guides/rum/product-features/mobile-performance/.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://docs-docusaurus.kinsta.page/user-guides/rum/product-features/session-replay/ios/.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://docs-docusaurus.kinsta.page/user-guides/rum/product-features/session-replay/ios/.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://docs-docusaurus.kinsta.page/user-guides/rum/product-features/session-replay/ios/.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://docs-docusaurus.kinsta.page/user-guides/rum/sdk-features/trace-exporter/.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://docs-docusaurus.kinsta.page/user-guides/rum/sdk-features/custom-spans/.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://docs-docusaurus.kinsta.page/user-guides/rum/sdk-features/trace-exporter/.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://docs-docusaurus.kinsta.page/user-guides/rum/sdk-features/custom-spans/.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 [![mobile-performance-hero](/assets/images/hero-ae701411e123f6f1658f5c199ca3f3e6.webp)](https://docs-docusaurus.kinsta.page/assets/images/hero-ae701411e123f6f1658f5c199ca3f3e6.webp) * 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://docs-docusaurus.kinsta.page/user-guides/rum/product-features/mobile-performance/.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://docs-docusaurus.kinsta.page/user-guides/rum/sdk-features/data-masking/.md)** Nov 9, 2025 iOS SDK 1.4.0 Added an iOS mask-view for the native SDK (ALPH-15201). **[Learn more](https://docs-docusaurus.kinsta.page/user-guides/rum/sdk-features/data-masking/.md)** Nov 3, 2025 iOS SDK 1.3.2 Fixed a missing session-replay function (ALPH-1234). **[Learn more](https://docs-docusaurus.kinsta.page/user-guides/rum/product-features/session-replay/ios/.md)** Oct 30, 2025 iOS SDK 1.3.1 Fixed a session-replay segment-index bug (ALPH-1234). **[Learn more](https://docs-docusaurus.kinsta.page/user-guides/rum/product-features/session-replay/ios/.md)** Oct 26, 2025 iOS SDK 1.3.0 [![mobile-performance-hero](/assets/images/hero-ae701411e123f6f1658f5c199ca3f3e6.webp)](https://docs-docusaurus.kinsta.page/assets/images/hero-ae701411e123f6f1658f5c199ca3f3e6.webp) * Added a screenshot change-detection filter for iOS Session Replay (ALPH-2515). **[Learn more](https://docs-docusaurus.kinsta.page/user-guides/rum/product-features/session-replay/ios/.md)** * Added mobile-vitals options (ALPH-2754). **[Learn more](https://docs-docusaurus.kinsta.page/user-guides/rum/product-features/mobile-performance/.md)** Sep 28, 2025 iOS SDK 1.2.6 * Emit Navigation events (ALPH-2546). * Added a Custom-measurement API. **[Learn more](https://docs-docusaurus.kinsta.page/user-guides/rum/sdk-features/custom-measurements/.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 [![mobile-performance-hero](/assets/images/hero-ae701411e123f6f1658f5c199ca3f3e6.webp)](https://docs-docusaurus.kinsta.page/assets/images/hero-ae701411e123f6f1658f5c199ca3f3e6.webp) * 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://docs-docusaurus.kinsta.page/user-guides/rum/product-features/mobile-performance/.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://docs-docusaurus.kinsta.page/user-guides/rum/product-features/session-replay/ios/.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://docs-docusaurus.kinsta.page/user-guides/rum/product-features/session-replay/ios/.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://docs-docusaurus.kinsta.page/user-guides/rum/product-features/session-replay/ios/.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://docs-docusaurus.kinsta.page/user-guides/rum/product-features/session-replay/ios/.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.