Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

• Source distribution: SDK now ships as Swift source instead of a pre-built XCFramework for both SPM and CocoaPods
• iOS 15 minimum: Deployment target raised from iOS 12 to iOS 15; all @available(iOS 15, *) guards removed
• execute() / execute2step() / executeWithEvents() removed: Use selectPlacements() with a unified onEvent callback instead of separate onLoad, onUnLoad, onShouldShowLoadingIndicator, onShouldHideLoadingIndicator, and onEmbeddedSizeChange callbacks
• viewName → identifier: Renamed across selectPlacements(), events(), purchaseFinalized(), and RoktLayout
• RoktLayout parameter changes: locationName → location; identifier is now required
• PlacementOptions → RoktPlacementOptions: Type renamed
• initWith(onInitComplete:) callback removed: Use globalEvents() to listen for RoktEvent.InitComplete instead
• setLoggingEnabled(enable:) removed: Use setLogLevel(_:) for granular log control

For a complete migration walkthrough with before/after code examples, see the v4 → v5 Migration Guide.

• Add trunk security scanning and remove stale Cortex catalog (#114)
• Bump actions/download-artifact from 7.0.0 to 8.0.1 (#113)
• Bump actions/create-github-app-token from 2.2.1 to 3.0.0 (#112)

• Migration guide for v4 to v5 upgrade (#115)

• XCFramework generated from RoktUXHelper 0.8.3 snapshot
• Bump iOS deployment target from 12.0 to 15.0 to align with RoktUXHelper requirements

• Update to RoktUXHelper 0.8.1 fixing SignalViewed events not being emitted — offers now correctly fire viewed events after 50%+ visibility for 1 second
• Fixed critical crash when users tap buttons in SDK layouts caused by invalid UTF-8 encoding in event data
• Fixed thread safety issue in real-time event processing that could cause crashes under high load
• Improved error handling and logging for event storage operations

• Fixed caching being silently enabled when building RoktConfig without an explicit CacheConfig

• Add PlacementOptions to support passing joint SDK timing data for placement selection

• Remove false positive font diagnostics requests on the first time init

• Add configurable log levels via Rokt.setLogLevel(_:)

• Deprecate Rokt.setLoggingEnabled(enable:) in favor of setLogLevel(_:)

• Added support for getting and setting session ID. If you use multiple integrations, such as webview and native within your app you can now set session ID so it is maintained across integration types.

• Updated timing data capture logic and added x-rokt-trace-id header

• Fixed thread safety crash when processing platform events

• Reverted temporary iOS view controller hierarchy changes introduced in 4.14.4.
• RoktUXHelper version 0.7.5

• Fix ScrollableColumn and ScrollableRow ignoring dimension maxHeight/maxWidth constraints when weight is set

• Embedded hosting controller cleanup to remove view controller lifecycle management

• Fixed cache attributes being used in place of all attributes

• RoktUXHelper version 0.7.4
• New animation styles supported in DataImageCarousel

• Fixed ProgressComponent

• Fixed thread safety crash in DistributionComponents when transitioning between offers

• Handle negative values in Progression predicate of When component

• UX Helper version updated to 0.7.0

• Add Discover to supported Apple Pay networks

• Add detection of Stripe SDK with Apple Pay capabilities

• Debounce embedded size change events
• Persist sessionId from API response regardless of whether layouts are selected

• EmbeddedSizeChanged now gets emitted as an event

• FirstPositiveEngagement is now emitted for all execute calls

• Real time events

• Enabled DSym on XCFramework export
• Add detection of Apple Pay and if a user is new to Apple Pay
• Sessions are now retained between app restarts

• Explicitly add @objc annotation to support Cart Item Instant Purchase

• Support for openURL passthrough option
• Thank you upsells layout
• Image carousel layout

• Limit size dimensions to 2 decimal places to fix precision issue

• Remove spacing when image download fails

• Fix color mode switch on RichText after progression

• iOS SDK using UXHelper module as rendering engine

• Minimum supported iOS version bumped to 12 (deprecated support for iOS 11 & 10)

• Fixed regression on weight property
• Flutter embedded overlap fix released behind feature flag
• Fixed carousel height
• Refactored dynamic-height bottomsheet to fix onLoad callback
• Added Flutter iOS arm64 simulator support

• Dynamic bottomsheet enhancements
• Fixed accessibility text cut-off
• Fixed carousel distribution height on iOS 18

• Fixed bottomsheet bottom-edge background color
• Fixed system font accessibility sizing

• Support for dynamic-height bottomsheet

• Support collapsing the embedded layout with the close button

• Fix color mode changes on the RichText component after progression
• Fix Arabic/Farsi localized numbers in event dates

• Fix Flutter embedded placement not tappable on second offer
• Add extra is-Rokt URL parameters under feature flag
• Bounding box rendering under feature flag
• Fix retry logic on nil-response in networking layer

• Fix empty Flutter embedded placement height
• Fix RoktWebview menu on iPadOS
• Align StaticImage dark-URL behavior with Android
• Align overlay vertical-alignment key with Android and Web

• Privacy Manifest support

• Fix overlay alignment

• Re-register fonts and log on font errors
• Fix dark-mode switch on iOS 17
• Fix crash on text progress indicator
• Fix creative title rendering twice
• Fix crash on negative response
• Fix threading crash in BaseDependencyInjection sharedItems
• Open linked URLs from bottomsheet in full-screen height