RUM iOS SDK changelog

• 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.

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

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

• 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

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).

The hybrid SDK path now honors excludeFromSampling (CX-40203).

• 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

Fixed a Flutter scroll freeze by using afterScreenUpdates: false.

Fixed the tracesExporter instrumentation_data payload and the TracesExporterViewController per-span table UI. Learn more

Hardened the Custom Spans API and fixed a network span 422 error (CX-39134). Learn more

• 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).

• Added the Traces Exporter (OTLP JSON) with a callback. Learn more
• 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
• Added the US3 domain to the CoralogixDomain enum.
• Fixed preservation of telemetry.sdk.* attributes in the OTel Resource.

Fixed traceparent header capture in the React Native / Flutter hybrid network path.

Added Flutter obfuscated errors plus error metadata (arch, build_id, stack_trace_type).

Forward request and response headers and payload in the Flutter hybrid network path.

Made Span conform to Equatable and record events conform to Hashable.

Made Span conform to Hashable.

• 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.

• 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

Eliminated delegate class scanning and migrated to industry-standard swizzling for multi-SDK compatibility.

• Added Flutter session-recording masking support.
• Fixed severity syncing from the beforeSend callback to CxSpan.

Fixed a negative-duration bug and now mark the session ID and session creation date correctly (CX-4620).

Wired ANR detection into the scheme (CX-26496).

Adopted async/await in internal APIs (CX-25861).

Added a masking bridge widget (ALPH-22252). Learn more

Added an iOS mask-view for the native SDK (ALPH-15201). Learn more

Fixed a missing session-replay function (ALPH-1234). Learn more

Fixed a session-replay segment-index bug (ALPH-1234). Learn more

• Added a screenshot change-detection filter for iOS Session Replay (ALPH-2515). Learn more
• Added mobile-vitals options (ALPH-2754). Learn more

• Emit Navigation events (ALPH-2546).
• Added a Custom-measurement API. Learn more
• 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.

Automated the CocoaPods release pipeline (ALPH-6671).

Bumped the PLCrashReporter dependency.

• Fixed the user-agent string.
• React Native integration fixes (ALPH-1234).

• Fixed broken spanid and traceid.
• Fixed an app freeze on the main thread.

• 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

Fixed an app crash in NSMutableURLRequest ObjC bridging (ALPH-2631).

• 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).

Fixed several crashes (ALPH-2498).

Refactored the idle logic (ALPH-2468).

• 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).

• Added traceparent header injection (native) (ALPH-2296).
• When using a proxy URL, the exporter now removes the span correctly (ALPH-2148).

• Added a traceparent header option on CoralogixOptions (ALPH-2295).
• Added proxy URL support (native) (ALPH-2292).
• Fixed a crash in SessionMetaDataManager (ALPH-2914).

• Changed duration handling, added undefined-text handling, and repaired broken tests (ALPH-2388).
• Fixed images being skipped during session recording (ALPH-2360). Learn more

• Added Flutter support for cold / warm mobile vitals (ALPH-1234).
• Initialize segmentIndex when the page is incremented (ALPH-2286).

• Added Session Replay click events (ALPH-1885).
• Added a disable-swizzling option (ALPH-2246). Learn more

• Added screenshot events in session recording (ALPH-2159).
• Fixed a crash in URLSessionInstrumentation (ALPH-2218). Learn more

• Merged Session Replay into the main module (ALPH-2183).
• Fixed a crash in URLSession instrumentation (ALPH-2195). Learn more

Added beforeSend logic.

• 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).

Fixed ignoreUrl and ignoreError API behavior.

• Added missing API functions (ALPH-2128).
• Fixed network requests not being captured in some cases (ALPH-2128).

Added new public API functions (ALPH-2214).

Switched the library to static linkage.

Fixed a crash in the UICollectionView swizzle.

• 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).

Fixed iOS 13 compatibility (Xcode 15.0.1).

• 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.

Added native enhancements for Flutter capabilities (ALPH-1137).

Added the CocoaPods podspec.

• Added OpenTelemetry API/SDK and PLCrashReporter as XCFrameworks.
• Added session-snapshot logic (ALPH-1187).
• Added OpenTelemetry SDK/API integration (ALPH-1187).

• Added ViewController extraction for Swift UIKit.
• Added ViewController extraction for SwiftUI (ALPH-1085).
• Added DeviceState and DeviceContext (ALPH-1112).

Initial release of the Coralogix iOS RUM SDK.