3.17.2

• Kids Mode: the SDK now sends the Apple Search Ads (AdServices) attribution token in Kids Category builds. The ASA token from AAAttribution is anonymized and first-party (not IDFA / AdSupport), so it is permitted under COPPA.
• Fixed an off-by-one in placement variation weight distribution that could slightly skew A/B traffic allocation at exact weight boundaries.

Full Changelog: 3.17.1...3.17.2

4.0.0-beta.1

⚠️ This is a beta pre-release of Adapty iOS SDK 4.0.0. APIs may still change before the stable 4.0.0.

🚀 Flow — the successor to Paywalls

4.0.0 introduces Flow, which replaces the Paywall as the core unit of presentation and analytics. A flow can contain multiple screens, with its rendering, navigation, and analytics driven by the new flow runtime. Paywall-centric APIs are renamed to flow-based equivalents (e.g. logShowPaywall → logShowFlow, paywall_showed → flow_showed).

👉 Read more about Adapty Flow Builder.
👉 See the Adapty docs for details and the migration guide.

📦 Installation

• Swift Package Manager only. CocoaPods support has been removed in 4.0.0 (podspecs are no longer published).
• This is a pre-release: pin the exact version, e.g. .exact("4.0.0-beta.1"). SPM does not resolve beta versions through from: / up-to-next-major rules.

💥 Breaking changes

Major release with public API changes across the core SDK and AdaptyUI. Highlights:

• Flow replaces Paywall: Adapty.logShowPaywall(_:) → Adapty.logShowFlow(_:); event paywall_showed → flow_showed (paywall_builder_id removed).
• Attribution & integrations: AdaptyProfile.AttributionSource → AdaptyAttributionSource; updateAttribution(_:source:) now takes a typed AdaptyAttributionSource; setIntegrationIdentifier(key:value:) → variadic, typed setIntegrationIdentifier(_:).
• Custom assets (AdaptyUICustomVideoAsset / fonts): video cases gained a trailing resolution: CGSize? parameter; the .player case now takes AVPlayer (was AVQueuePlayer); the .font case now carries an AdaptyUICustomFontAsset (default color / letter spacing / line height) instead of a bare UIFont.
• AdaptyUI error handling: callback didFailRendering → didReceiveError (now also surfaces JS runtime errors via the new AdaptyUIError.jsException / AdaptyUIBuilderError.jsException case); the plugin wire event flow_view_did_fail_rendering → flow_view_did_receive_error.
• CocoaPods support dropped — SPM only.

❗️ Don't forget to update your local fallback file if needed.

Full Changelog: 3.17.1...4.0.0-beta.1

3.17.1

• Added AdaptyProfile.appliedAttributionSources: [AttributionSource] — identifiers of attribution sources applied to the profile and available for segmentation. Use AttributionSource.appleAds for comparison against the known Apple Search Ads identifier.

Full Changelog: 3.17.0...3.17.1

3.17.0

• AdaptyUI: the Action.openURL case now carries an in: AdaptyWebPresentation parameter (externalBrowser / inAppBrowser). Default handlers honor it via SFSafariViewController for inAppBrowser and UIApplication.open for externalBrowser.
• Various bugfixes and stability improvements.

⚠️ Breaking Changes

• AdaptyUI.Action.openURL signature changed from openURL(url: URL) to openURL(url: URL, in: AdaptyWebPresentation). Update your AdaptyPaywallControllerDelegate / AdaptyPaywallView action handlers to accept the new parameter.

Full Changelog: 3.15.7...3.17.0

3.15.7

• Fixed support for Xcode 26.4 (#152)

3.15.6

AdaptyUI: fixed a glitch where a video with transparency could blink in some cases

3.15.5

• Fixed backend errors handling.
• Fix Swift 6 Sendability mismatch for closure parameters crossing isolation boundaries (#148).

Full Changelog: 3.15.4...3.15.5

3.15.4

• Fixed a bug where enabling the BUILD_LIBRARY_FOR_DISTRIBUTION option in Xcode led to build issues

3.15.3

• [Crossplatform Support] Fixed a bug where the placementId value was incorrect for AdaptyUIPaywallView.

Full Changelog: 3.15.2...3.15.3

3.15.2

• Now it is possible to prevent a new profile from being created after restoring a device from an iCloud backup by using the .with(clearDataOnBackup: true) setting in AdaptyConfiguration.

Full Changelog: 3.15.1...3.15.2