NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #2585 most downloaded on pub.dev
Adapty SDK is an open-source framework that makes implementing in-app subscriptions in Flutter applications fast and easy. It’s 100% open-source and lightweight.
Latest stable
4.3.1
Last release 11 days ago
11 Nov 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 58 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
6 years old
95 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
[Android] Adapty().getFlow() and Adapty().getOnboarding() could take longer than loadTimeout when the server was slow to respond.
Adapty().getFlow() and Adapty().getOnboarding() could take longer than loadTimeout when the server was slow to respond.Full Changelog: 4.3.0...4.3.1
Adapty().getFlow() and Adapty().getOnboarding() could take longer than loadTimeout when the server was slow to respond.Native dependencies in this release: iOS 4.3.2, Android 4.3.3 (crossplatform 4.3.1).
❗️ Don't forget to update your local fallback file if needed.
Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/4.3.0...4.3.1
[Android] Google Play in-app messages, such as payment decline notices, are now shown by default: the SDK asks Google Play for them each time an activ
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Adapty().activate(), including when the app returns to the foreground and when an AdaptyUI flow or onboarding is presented or dismissed, so a message can appear over a paywall. An activity that started before activate() does not count, so to show the messages at launch, call Adapty().showStoreMessages() on Android once after activate(); on iOS below 16 that call fails. To keep the previous behavior, activate with .withStoreMessagesHandling(AdaptyStoreMessagesHandling.manual) on Android only: on iOS 16 and later, manual also holds App Store messages until you call Adapty().showStoreMessages().flowViewDidReceiveAnalyticEvent and AdaptyUIFlowPlatformView.onDidReceiveAnalyticEvent as int instead of double. Read numeric parameters as num.onboardingViewOnStateUpdatedAction and AdaptyUIOnboardingPlatformView.onStateUpdatedAction as AdaptyOnboardingsEmailInput; before, they arrived as AdaptyOnboardingsTextInput. Handle AdaptyOnboardingsEmailInput too.AdaptyOnboardingsInputParams or an AdaptyOnboardingsInput now shows the entered value, so review any logging of them.AdaptyProductSubscription.pricingTerms describes the plan, Adapty().makePurchase() buys it, and AdaptyErrorCode.billingPlanUnavailable reports a plan that can't be bought. For such a product, AdaptyPaywallProduct.price and subscription.period (and localizedPeriod) cover the whole commitment; show the installment from pricingTerms.billingPrice and pricingTerms.billingPeriod. Read how 12-month commitment plans work and how to set one up.AdaptyAccessLevel and AdaptySubscription report billingPlan and, for a commitment plan, commitmentInfo. AdaptySubscription.billingPlan is upFront for a subscription bought without a commitment plan, including every Google Play purchase..withStoreMessagesHandling(AdaptyStoreMessagesHandling.manual) on AdaptyConfiguration, App Store and Google Play messages are shown only when you call Adapty().showStoreMessages(). On iOS this works on iOS 16 and later; below that, StoreKit shows App Store messages itself.Adapty().getPendingStoreMessageTypes() returns the types of the held messages, and Adapty().showStoreMessages(iosFilter: ...) shows only the given AdaptyStoreMessageTypes.Adapty().showStoreMessages() can fail with the new AdaptyErrorCode.operationInProgress and AdaptyErrorCode.resolverFailure.Adapty().preloadFlows() and Adapty().preloadFlowsForDefaultAudience() load flows into the cache, so that Adapty().getFlow() or Adapty().getFlowForDefaultAudience() with AdaptyFlowFetchPolicy.returnCacheDataElseLoad, or with returnCacheDataIfNotExpiredElseLoad while the cached flow is not older than maxAge, returns them without a network request. On a test device both getters skip the cache and load from the network, falling back to the cached flow only if that request fails.AdaptyUI().destroyFlowView() and AdaptyUIFlowView.destroy() release a view that was never presented, a view kept alive by dismiss(destroy: false), or one the user swiped down when it was presented as a page sheet on iOS.AdaptyFlow.variationName returns the name of the flow's variation.Adapty().reportTransaction() takes an optional appleJwsTransaction: in Observer mode, pass the JWS of the reported StoreKit 2 transaction when your purchase library provides it.offerId of AdaptyAccessLevel and AdaptySubscription was always null on iOS, and activePromotionalOfferId was always null on Android..withLogLevel() on AdaptyConfiguration also sets the level of the logs this package prints.Adapty().activate() keeps a level set with Adapty().setLogLevel() before it, unless the configuration sets one with .withLogLevel().onboardingViewOnStateUpdatedAction and AdaptyUIOnboardingPlatformView.onStateUpdatedAction as AdaptyOnboardingsNumberInput. Before, their updates never arrived.Adapty().makePurchase(), the SDK acknowledged the purchase instead of consuming it, so the product could stay owned and not be bought again.AdaptyPaywallProduct.subscription.offer and in flows, is selected only for a user who has had an auto-renewable subscription in the app; other users get the introductory offer, if they are eligible, or no offer. Before, the SDK did not check this on the device.Adapty().makePurchase() or in a flow is validated once Google Play approves it: right away if the app is running, otherwise when it returns to the foreground. Before, it waited for the next activation.Adapty().makePurchase(), or a purchase in a flow, could wait forever when Google Play reported a purchase of another product while it was in progress. Now it completes with the requested product's purchase if Google Play has one, as AdaptyPurchaseResultPending if that purchase is pending, or as AdaptyPurchaseResultUserCancelled if not..withGoogleLocalAccessLevelAllowed(true), Adapty().didUpdateProfileStream delivered only the first profile update after launch.currencySymbol of the price of a subscription offer phase (subscription.offer.phases of AdaptyPaywallProduct and AdaptyPromotedProduct) was always null.AdaptyPaywallProduct.paywallProductIndex was always 0, so a web paywall opened for a product got the first product's index.NaN or an infinite number.❗️ Don't forget to update your local fallback file if needed.
Full Changelog: 4.1.1...4.3.0
AdaptyCustomAsset.linearGradient accepts AlignmentDirectional and mixed begin / end values, resolved left-to-right. Before, the flow failed to open wi
AdaptyCustomAsset.linearGradient accepts AlignmentDirectional and mixed begin/end values, resolved left-to-right. Before, the flow failed to open with a TypeError.AdaptyUI.createFlowView fails with an AdaptyError (wrongParam) naming a custom asset it can't encode, instead of a raw ArgumentError or JsonUnsupportedObjectError.transform, or a tileMode other than TileMode.clamp, on a custom LinearGradient is still ignored and now logs a warning.❗️ Don't forget to update your local fallback file if needed.
Full Changelog: 4.1.0...4.1.1
External attribution APIs are renamed, with no deprecated aliases: .updateAttribution() is now .updateExternalAttribution() , AdaptyAttributionSource…
👉 See the migration guide for the full details.
.updateAttribution() is now .updateExternalAttribution(), AdaptyAttributionSource is now AdaptyExternalAttributionProvider, and AdaptyProfile.appliedAttributionSources is now appliedExternalAttributionProviders..withAdaptyAttributionEnabled(true) on your AdaptyConfiguration.AdaptyExternalAttributionProvider ships appleAds, adjust, appsflyer, branch, tenjin, and custom.Adapty().didReceivePromotedPurchaseStream; complete it with .makePromotedPurchase(). While nothing is subscribed to that stream, the SDK completes the purchase itself. Requires iOS 16.4 or later.AdaptyUI.dismissFlowView and AdaptyUIFlowView.dismiss accept destroy: false to keep the view alive after dismissing it: presenting it again resumes on the screen the user left. The default destroy: true releases the view as before.preloadProducts had no effect on AdaptyUI.createFlowView.flowViewDidReceiveAnalyticEvent as numbers; before, every 0/1 arrived as false/true.❗️ Don't forget to update your local fallback file if needed.
Full Changelog: 4.0.4...4.1.0
👉 See the migration guide for the full details.
.updateAttribution() is now .updateExternalAttribution(), AdaptyAttributionSource is now AdaptyExternalAttributionProvider, and AdaptyProfile.appliedAttributionSources is now appliedExternalAttributionProviders..withAdaptyAttributionEnabled(true) on your AdaptyConfiguration.AdaptyExternalAttributionProvider ships appleAds, adjust, appsflyer, branch, tenjin, and custom.Adapty().didReceivePromotedPurchaseStream; complete it with .makePromotedPurchase(). While nothing is subscribed to that stream, the SDK completes the purchase itself. Requires iOS 16.4 or later.AdaptyUI.dismissFlowView and AdaptyUIFlowView.dismiss accept destroy: false to keep the view alive after dismissing it: presenting it again resumes on the screen the user left. The default destroy: true releases the view as before.preloadProducts had no effect on AdaptyUI.createFlowView.flowViewDidReceiveAnalyticEvent as numbers; before, every 0/1 arrived as false/true.Native dependencies in this release: iOS 4.1.3, Android 4.1.1 (crossplatform 4.1.5).
❗️ Don't forget to update your local fallback file.
Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/4.0.4...4.1.0
[Android] restorePurchases() no longer throws when there is nothing to restore. It now completes successfully with the current AdaptyProfile — check t
restorePurchases() no longer throws when there is nothing to restore. It now completes successfully with the current AdaptyProfile — check the access level in the returned profile instead of catching an error. If your code treats a failed restore as "nothing to restore", that branch will no longer be reached on Android.text_color and text_background keys. The old color and background keys are still read, so views built before the change keep rendering as they did. Affected both platforms.AdaptyErrorCode.noPurchasesToRestore — no longer returned on Android. Check the access level status in the profile returned by restorePurchases().Native dependencies in this release: iOS 4.0.3, Android 4.0.2.
❗️ Don't forget to update your local fallback file if needed.
Full Changelog: 4.0.3...4.0.4
restorePurchases() no longer fails with noPurchasesToRestore when there is nothing to restore. It now completes successfully with the current AdaptyProfile — check the access level status in the returned profile instead of catching an error. AdaptyErrorCode.noPurchasesToRestore is deprecated on Android.text_color and text_background keys. The old color and background keys are still read, so views built before the change keep rendering as they did. Fixed on both platforms.4.0.3.4.0.2.The locale argument of getFlow and getFlowForDefaultAudience has had no effect on flows since 4.0.0. It is now deprecated and logs a warning instead o…
This resolves the known issue in 4.0.0, 4.0.1 and 4.0.2, where localized flows were not supported.
AdaptyUI.createFlowView and AdaptyUIFlowPlatformView now accept a locale — the localization the flow view is rendered with. Since 4.0.0 a flow is localized when its view is built, and there was no way to choose that localization from Dart.
Without a locale the view is rendered in en, falling back to the flow's default localization when the flow has no en. Asking for a localization the flow does not have falls back to the flow default as well, without an error. Strings missing from the chosen localization are filled in from the default one.
AdaptyUIFlowView now reports the locale the view was actually built with, so you can tell which localization was applied.
LinearGradient had no explicit stops — the idiomatic LinearGradient(colors: [a, b]) reached the native side with no colors at all. Affected both platforms.locale argument of getFlow and getFlowForDefaultAudience has had no effect on flows since 4.0.0. It is now deprecated and logs a warning instead of being dropped silently — pass the locale to createFlowView or AdaptyUIFlowPlatformView instead.Native dependencies in this release: iOS 4.0.2, Android 4.0.1.
Full Changelog: 4.0.2...4.0.3
The "paywall" concept is generalized into flow ; most Paywall / paywall symbols are renamed to Flow / flow , and previously deprecated aliases are rem…
freed pointer was not the last allocation) when a placement was served from cache, on Xcode 26.3 / Swift 6.2.4 release builds.adapty_flutter_kids no longer imports AppTrackingTransparency — the native ATT surface is now fully compiled out under the kids trait.Native iOS SDK dependency is pinned to 4.0.1 in this release.
Known issue: The locale field is missing from the flow model, so localized flows are not supported in this version. Fixed in 4.0.3.
Full Changelog: 4.0.1...4.0.2
⚠️ Major release with breaking API changes. The "paywall" concept is generalized into flow; most
Paywall/paywallsymbols are renamed toFlow/flow, and previously deprecated aliases are removed.
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.
👉 Read more about Adapty Flow Builder.
👉 See the migration guide to move from 3.x.
flutter config --enable-swift-package-manager; Flutter 3.44+ enables it by default.AdaptyPaywall is split into AdaptyFlow (+ AdaptyFlowPaywall); AdaptyUIPaywallView → AdaptyUIFlowView; Adapty().getPaywall(...) → getFlow(...) and getPaywallForDefaultAudience(...) → getFlowForDefaultAudience(...); AdaptyUI().createPaywallView(...) → createFlowView(...); logShowPaywall(...) → logShowFlow(...).AdaptyUIPaywallsEventsObserver → AdaptyUIFlowsEventsObserver (setPaywallsEventsObserver → setFlowsEventsObserver); all paywallViewDid* callbacks → flowViewDid*. The separate rendering-failure callback is folded into flowViewDidReceiveError.AdaptyPaywallViewConfiguration is no longer exposed; the view configuration is now opaque.Adapty.setFallbackPaywalls() (use setFallback()), AdaptyConfigurationBuilder.withIdfaCollectionDisabled() (use withAppleIdfaCollectionDisabled()), AdaptyFlow.placementId / AdaptyFlow.revision (use placement.id / placement.revision), AdaptyPurchaseResultSuccess.jwsTransaction (use appleJwsTransaction), and AdaptyUIFlowView.paywallVariationId (use variationId).AndroidSystemBackAction in your events observer if you want it to close the flow.AdaptyUISystemRequestsHandler — handle flow system requests (OS permission prompts and App Store review requests) triggered by flow actions. Register via AdaptyUI().setSystemRequestsHandler(...).AdaptyUIObserverModeResolver — drive purchases and restores initiated from flows while running in Observer Mode. Register via AdaptyUI().setObserverModeResolver(...).flowViewDidReceiveAnalyticEvent — receive customer-facing analytic events emitted by a flow.Adapty.openWebPaywall and Adapty.createWebPaywallUrl now accept an AdaptyFlowPaywall in addition to an AdaptyPaywallProduct.setFlowsEventsObserver / setOnboardingsEventsObserver now accept null to detach a previously set observer, so the SDK no longer retains it (useful for cleanup).AdaptyOnboarding, AdaptyUIOnboardingView, AdaptyUIOnboardingPlatformView, AdaptyUIOnboardingsEventsObserver, the onboarding state / input / analytics models, and the related Adapty / AdaptyUI methods (getOnboarding, getOnboardingForDefaultAudience, create/present/dismissOnboardingView, register/unregister/setOnboardingsEventsObserver) are now annotated @Deprecated.Full Changelog: 3.17.1...4.0.0
freed pointer was not the last allocation) when a placement was served from cache, on Xcode 26.3 / Swift 6.2.4 release builds.adapty_flutter_kids no longer imports AppTrackingTransparency — the native ATT surface is now fully compiled out under the kids trait.4.0.1.Known issue: The locale field is missing from the flow model, so localized flows are not supported in this version. Fixed in 4.0.3.
The "paywall" concept is generalized into flow ; most Paywall / paywall symbols are renamed to Flow / flow , and previously deprecated aliases are rem…
Known issue: The locale field is missing from the flow model, so localized flows are not supported in this version. Fixed in 4.0.3.
Full Changelog: 4.0.0...4.0.1
⚠️ Major release with breaking API changes. The "paywall" concept is generalized into flow; most
Paywall/paywallsymbols are renamed toFlow/flow, and previously deprecated aliases are removed.
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.
👉 Read more about Adapty Flow Builder.
👉 See the migration guide to move from 3.x.
flutter config --enable-swift-package-manager; Flutter 3.44+ enables it by default.AdaptyPaywall is split into AdaptyFlow (+ AdaptyFlowPaywall); AdaptyUIPaywallView → AdaptyUIFlowView; Adapty().getPaywall(...) → getFlow(...) and getPaywallForDefaultAudience(...) → getFlowForDefaultAudience(...); AdaptyUI().createPaywallView(...) → createFlowView(...); logShowPaywall(...) → logShowFlow(...).AdaptyUIPaywallsEventsObserver → AdaptyUIFlowsEventsObserver (setPaywallsEventsObserver → setFlowsEventsObserver); all paywallViewDid* callbacks → flowViewDid*. The separate rendering-failure callback is folded into flowViewDidReceiveError.AdaptyPaywallViewConfiguration is no longer exposed; the view configuration is now opaque.Adapty.setFallbackPaywalls() (use setFallback()), AdaptyConfigurationBuilder.withIdfaCollectionDisabled() (use withAppleIdfaCollectionDisabled()), AdaptyFlow.placementId / AdaptyFlow.revision (use placement.id / placement.revision), AdaptyPurchaseResultSuccess.jwsTransaction (use appleJwsTransaction), and AdaptyUIFlowView.paywallVariationId (use variationId).AndroidSystemBackAction in your events observer if you want it to close the flow.AdaptyUISystemRequestsHandler — handle flow system requests (OS permission prompts and App Store review requests) triggered by flow actions. Register via AdaptyUI().setSystemRequestsHandler(...).AdaptyUIObserverModeResolver — drive purchases and restores initiated from flows while running in Observer Mode. Register via AdaptyUI().setObserverModeResolver(...).flowViewDidReceiveAnalyticEvent — receive customer-facing analytic events emitted by a flow.Adapty.openWebPaywall and Adapty.createWebPaywallUrl now accept an AdaptyFlowPaywall in addition to an AdaptyPaywallProduct.setFlowsEventsObserver / setOnboardingsEventsObserver now accept null to detach a previously set observer, so the SDK no longer retains it (useful for cleanup).AdaptyOnboarding, AdaptyUIOnboardingView, AdaptyUIOnboardingPlatformView, AdaptyUIOnboardingsEventsObserver, the onboarding state / input / analytics models, and the related Adapty / AdaptyUI methods (getOnboarding, getOnboardingForDefaultAudience, create/present/dismissOnboardingView, register/unregister/setOnboardingsEventsObserver) are now annotated @Deprecated.Full Changelog: 3.17.1...4.0.0
4.0.0 (was from: "4.0.0"). The Flutter bridge targets this exact native version, so the plugin no longer resolves to newer 4.x native releases it wasn't built against.Known issue: The locale field is missing from the flow model, so localized flows are not supported in this version. Fixed in 4.0.3.
The "paywall" concept is generalized into flow ; most Paywall / paywall symbols are renamed to Flow / flow , and previously deprecated aliases are rem…
⚠️ Major release with breaking API changes. The "paywall" concept is generalized into flow; most
Paywall/paywallsymbols are renamed toFlow/flow, and previously deprecated aliases are removed.
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.
👉 Read more about Adapty Flow Builder.
👉 See the migration guide to move from 3.x.
flutter config --enable-swift-package-manager; Flutter 3.44+ enables it by default.AdaptyPaywall is split into AdaptyFlow (+ AdaptyFlowPaywall); AdaptyUIPaywallView → AdaptyUIFlowView; Adapty().getPaywall(...) → getFlow(...) and getPaywallForDefaultAudience(...) → getFlowForDefaultAudience(...); AdaptyUI().createPaywallView(...) → createFlowView(...); logShowPaywall(...) → logShowFlow(...).locale you pass to createFlowView or AdaptyUIFlowPlatformView must equal one of the flow's localization codes character by character; otherwise the flow falls back to its default localization. Add a localization for every regional code your users have (e.g. pt-br next to pt), and pass the code in the same form. See Localizations and locale codes.AdaptyUIPaywallsEventsObserver → AdaptyUIFlowsEventsObserver (setPaywallsEventsObserver → setFlowsEventsObserver); all paywallViewDid* callbacks → flowViewDid*. The separate rendering-failure callback is folded into flowViewDidReceiveError.AdaptyPaywallViewConfiguration is no longer exposed; the view configuration is now opaque.Adapty.setFallbackPaywalls() (use setFallback()), AdaptyConfigurationBuilder.withIdfaCollectionDisabled() (use withAppleIdfaCollectionDisabled()), AdaptyFlow.placementId / AdaptyFlow.revision (use placement.id / placement.revision), AdaptyPurchaseResultSuccess.jwsTransaction (use appleJwsTransaction), and AdaptyUIFlowView.paywallVariationId (use variationId).AndroidSystemBackAction in your events observer if you want it to close the flow.AdaptyUISystemRequestsHandler — handle flow system requests (OS permission prompts and App Store review requests) triggered by flow actions. Register via AdaptyUI().setSystemRequestsHandler(...).AdaptyUIObserverModeResolver — drive purchases and restores initiated from flows while running in Observer Mode. Register via AdaptyUI().setObserverModeResolver(...).flowViewDidReceiveAnalyticEvent — receive customer-facing analytic events emitted by a flow.Adapty.openWebPaywall and Adapty.createWebPaywallUrl now accept an AdaptyFlowPaywall in addition to an AdaptyPaywallProduct.setFlowsEventsObserver / setOnboardingsEventsObserver now accept null to detach a previously set observer, so the SDK no longer retains it (useful for cleanup).AdaptyOnboarding, AdaptyUIOnboardingView, AdaptyUIOnboardingPlatformView, AdaptyUIOnboardingsEventsObserver, the onboarding state / input / analytics models, and the related Adapty / AdaptyUI methods (getOnboarding, getOnboardingForDefaultAudience, create/present/dismissOnboardingView, register/unregister/setOnboardingsEventsObserver) are now annotated @Deprecated.Known issue: The locale field is missing from the flow model, so localized flows are not supported in this version. Fixed in 4.0.3.
Full Changelog: 3.17.1...4.0.0
⚠️ Major release with breaking API changes. The "paywall" concept is generalized into "flow"; most
Paywall/paywallUI symbols are renamed toFlow/flow, and previously deprecated aliases are removed.
AdaptyPaywall is split into AdaptyFlow (+ AdaptyFlowPaywall); AdaptyUIPaywallView → AdaptyUIFlowView; Adapty().getPaywall(...) → getFlow(...) and getPaywallForDefaultAudience(...) → getFlowForDefaultAudience(...); AdaptyUI().createPaywallView(...) → createFlowView(...); logShowPaywall(...) → logShowFlow(...).AdaptyUIPaywallsEventsObserver → AdaptyUIFlowsEventsObserver (setPaywallsEventsObserver → setFlowsEventsObserver); all paywallViewDid* callbacks → flowViewDid*. The separate rendering-failure callback is folded into flowViewDidReceiveError.AdaptyPaywallViewConfiguration is no longer exposed; the view configuration is now opaque.Adapty.setFallbackPaywalls() (use setFallback()), AdaptyConfigurationBuilder.withIdfaCollectionDisabled() (use withAppleIdfaCollectionDisabled()), AdaptyFlow.placementId / AdaptyFlow.revision (use placement.id / placement.revision), AdaptyPurchaseResultSuccess.jwsTransaction (use appleJwsTransaction), and AdaptyUIFlowView.paywallVariationId (use variationId).AndroidSystemBackAction in your events observer if you want it to close the flow.flutter config --enable-swift-package-manager; Flutter 3.44+ enables it by default.AdaptyUISystemRequestsHandler — handle flow system requests (OS permission prompts and App Store review requests) triggered by flow actions. Register via AdaptyUI().setSystemRequestsHandler(...).AdaptyUIObserverModeResolver — drive purchases and restores initiated from flows while running in Observer Mode. Register via AdaptyUI().setObserverModeResolver(...).flowViewDidReceiveAnalyticEvent — receive customer-facing analytic events emitted by a flow.Adapty.openWebPaywall and Adapty.createWebPaywallUrl now accept an AdaptyFlow (uses the flow's first paywall variation) in addition to an AdaptyPaywallProduct.setFlowsEventsObserver / setOnboardingsEventsObserver now accept null to detach a previously set observer, so the SDK no longer retains it (useful for cleanup).AdaptyOnboarding, AdaptyUIOnboardingView, AdaptyUIOnboardingPlatformView, AdaptyUIOnboardingsEventsObserver, the onboarding state / input / analytics models, and the related Adapty/AdaptyUI methods (getOnboarding, getOnboardingForDefaultAudience, create/present/dismissOnboardingView, register/unregister/setOnboardingsEventsObserver) are now annotated @Deprecated.Known issue: The locale field is missing from the flow model, so localized flows are not supported in this version. Fixed in 4.0.3.
[iOS] Updated native iOS SDK to 3.17.3, fixing a crash when a placement was served from cache on recent Xcode / Swift Release builds.
[Android] Updated native Android SDK to 3.17.2.
> ⚠️ Swift Package Manager support is experimental. If anything doesn't work with the SwiftPM integration, please report it at https://github.com/adap
⚠️ Swift Package Manager support is experimental. If anything doesn't work with the SwiftPM integration, please report it at https://github.com/adaptyteam/AdaptySDK-Flutter/issues. Kids Mode does not work with SwiftPM yet — use the CocoaPods integration if you need Kids Mode.
3.15.0 the SDK has been compatible with Billing Library 8 (opt-in); it is now used by default.OpenUrlAction now carries an openIn parameter (AdaptyWebPresentation) indicating where the URL should be opened — external browser or in-app browser.AdaptyProfile now exposes appliedAttributionSources (List<AdaptyAttributionSource>), reporting which attribution sources have been applied to the profile (e.g. appleSearchAds).Package.swift alongside the CocoaPods podspec, so apps with SwiftPM enabled build it via SwiftPM while CocoaPods keeps working unchanged. #184OpenUrlAction constructor signature changed: it now requires a second positional argument openIn of type AdaptyWebPresentation.OpenUrlAction now carries an openIn parameter (AdaptyWebPresentation) indicating where the URL should be opened — external browser or in-app browser.Package.swift alongside the CocoaPods podspec, so apps with SwiftPM enabled build it via SwiftPM while CocoaPods keeps working unchanged.AdaptyProfile now exposes appliedAttributionSources (List<AdaptyAttributionSource>), reporting which attribution sources have been applied to the profile (e.g. appleSearchAds).OpenUrlAction constructor signature changed: it now requires a second positional argument openIn of type AdaptyWebPresentation. The action instances are normally produced by the SDK from native events, so most integrations are unaffected; direct constructions need an explicit openIn.[iOS] Updated native iOS SDK to 3.15.7.
[iOS] Fixed backend errors handling.
Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.15.3...3.15.4
[iOS] Fixed a bug where the placementId value was incorrect for AdaptyUIPaywallView.
placementId value was incorrect for AdaptyUIPaywallView.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.15.2...3.15.3
Onboardings: External links now work correctly. You can configure which browser is used by passing the externalUrlsPresentation parameter to the .crea
externalUrlsPresentation parameter to the .createOnboardingView method or to the AdaptyUIOnboardingPlatformView constructor (.inAppBrowser by default)..withAppleClearDataOnBackup() setting in AdaptyConfiguration.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.15.1...3.15.2
[Android] Custom tags, timers, and assets now work correctly with AdaptyUIPaywallPlatformView
AdaptyUIPaywallPlatformViewaccessLevelId property for AdaptyPaywallProduct.createWebPaywallUrl() or .openWebPaywall() to navigate users to an external webpage with alternative checkout options. Read More..openWebPaywall() method now supports a new openIn parameter. Available options: externalBrowser (default) and inAppBrowser.customerUserId is in UUID format..withBackendBaseUrl(), .withBackendFallbackBaseUrl(), .withBackendConfigsBaseUrl(), .withBackendUABaseUrl() methods of AdaptyConfiguration were being removed, please use .withServerCluster() method to configure the SDK❗️ Don't forget to update your local fallback file if needed.
Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.11.4...3.15.1
Support for Local Access Levels, allowing the SDK to verify purchases directly with the store even when Adapty servers are unreachable. Read More.
accessLevelId property for AdaptyPaywallProduct.createWebPaywallUrl() or .openWebPaywall() to navigate users to an external webpage with alternative checkout options. Read More..openWebPaywall() method now supports a new openIn parameter. Available options: externalBrowser (default) and inAppBrowser.customerUserId is in UUID format..withBackendBaseUrl(), .withBackendFallbackBaseUrl(), .withBackendConfigsBaseUrl(), .withBackendUABaseUrl() methods of AdaptyConfiguration were being removed, please use .withServerCluster() method to configure the SDK❗️ Don't forget to update your local fallback file if needed.
[iOS] Fixed a bug where custom timers would start at zero. #174
❗️Known Issues
customerUserId is in UUID format, you may encounter an error when purchasing products with Promotional Offers. Please update to version 3.15.0 or later.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.11.3...3.11.4
[Android] Fixed onboarding dismiss issue
❗️Known Issues
customerUserId is in UUID format, you may encounter an error when purchasing products with Promotional Offers. Please update to version 3.15.0 or later.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.11.2...3.11.3
Support for Adapty Android SDK 3.11.1
❗️Known Issues
customerUserId is in UUID format, you may encounter an error when purchasing products with Promotional Offers. Please update to version 3.15.0 or later.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.11.1...3.11.2
[Android] Fixed AdaptyUIOnboardingPlatformView events
AdaptyUIOnboardingPlatformView events❗️Known Issues
customerUserId is in UUID format, you may encounter an error when purchasing products with Promotional Offers. Please update to version 3.15.0 or later.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.11.0...3.11.1
Onboarding Builder now supports localizations. Read More.
❗️Known Issues
customerUserId is in UUID format, you may encounter an error when purchasing products with Promotional Offers. Please update to version 3.15.0 or later.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.10.0...3.11.0
AdaptyUI: added support for purchase button animations.
productPurchaseParams in .createPaywallView method (#130, #149).Deprecations:
.makePurchase method instead of subscriptionUpdateParams and isOfferPersonalized arguments use parameters.AdaptyPaywall model instead of vendorProductIds use productIdentifiers.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.9.0...3.10.0
Added support for the User Acquisition feature. Read more.
Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.8.4...3.9.0
Changed the makePurchase() method signature when using parameters other than product – they have been extracted into AdaptyPurchaseParameters
makePurchase() method signature when using parameters other than product – they have been extracted into AdaptyPurchaseParametersobfuscatedProfileId and obfuscatedAccountIdFull Changelog: 3.8.3...3.8.4
[Android] Fixed AdaptyUI rendering issues
Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.8.1...3.8.3
⚠️ Please use [3.8.3]
⚠️ Please use 3.8.3
- [iOS] Fixed dependency issue Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.8.0...3.8.1
Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.8.0...3.8.1
Meet the Adapty Flutter SDK 3.8.0!
Meet the Adapty Flutter SDK 3.8.0!
assetsResolver parameter to getPaywallConfiguration method.paywallPlacementId and paywallVariationId public fields for AdaptyPaywallController.AdaptyUIView was renamed to AdaptyUIPaywallView.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.6.1...3.8.0
🎉 With this version we're introducing support for the Onboarding Builder that allows your non-technical teams to create attractive and customizable onboarding flows without coding. Read More.
assetsResolver parameter to getPaywallConfiguration method.paywallPlacementId and paywallVariationId public fields for AdaptyPaywallController.setFallbackPaywalls(fileURL:) renamed to setFallback(fileURL:).AdaptyUIView was renamed to AdaptyUIPaywallView.Crossplacement A/B Test: Introduced support for Crossplacement A/B testing – a test type that spans multiple placements within your app. Read more.
.createWebPaywallUrl or .openWebPaywall to navigate users to an external webpage with alternative checkout options. Read More.profileWasChanged error could be thrown when calling .getPaywall immediately after activating the sdk with a customerUserId.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.4.1...3.6.1
⚠️ Please use [3.6.1]
⚠️ Please use 3.6.1
.createWebPaywallUrl or .openWebPaywall to navigate users to an external webpage with alternative checkout options. Read More.profileWasChanged error could be thrown when calling .getPaywall immediately after activating the sdk with a customerUserId.- Fixed support for Xcode 16.3
Added audienceName property to AdaptyPaywall struct.
audienceName property to AdaptyPaywall struct.updateCollectingRefundDataConsent and updateRefundPreference methods. Read More.reportTransaction behaviour for iOS and Android.AdaptyConfiguration: withIdfaCollectionDisabled is now deprecated, use withAppleIdfaCollectionDisabled instead.
AdaptyConfiguration: add withAppleIdfaCollectionDisabled parameter.AdaptyConfiguration: add withGoogleAdvertisingIdCollectionDisabled parameter.AdaptyConfiguration: withIdfaCollectionDisabled is now deprecated, use withAppleIdfaCollectionDisabled instead.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.3.1...3.3.2
withAppleIdfaCollectionDisabled parameter.withGoogleAdvertisingIdCollectionDisabled parameter.withIdfaCollectionDisabled is now deprecated, use withAppleIdfaCollectionDisabled instead.[Android] Fix AdaptyUI Close button
You no longer need to activate AdaptyUI separately, as it is now handled automatically during the usual activation process. Use .withMediaCacheConfigu
.withMediaCacheConfiguration in AdaptyConfiguration if you wish to override the default settings:await Adapty().activate(
configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
..withMediaCacheConfiguration(...),
);
New Method for Setting Integration Identifiers:
setIntegrationIdentifier(key:value:):
updateProfile method, passing integration IDs to the builder.setIntegrationIdentifier to set integration identifiers with a key and value.Updated updateAttribution Method:
source parameter is now a String instead of an enum.networkUserId parameter has been removed. Use setIntegrationIdentifier to set the networkUserId instead.setVariationId() with reportTransaction(transactionId:,variationId:) after every transaction.finish().variationId parameter in reportTransaction is now optional.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.2.5...3.3.0
[iOS] Fix an issue where an unwanted profile was sometimes created after the identify method was called
identify method was calledFull Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.2.4...3.2.5
identify method was called[iOS] Added support for Xcode 16.2
AdaptyUI: Internal improvements to paywall rendering
isActivated() method returned incorrect valuecontent field of AdaptyUIDialog was not displaying correctlysubscriptionUpdateParams wrong serialization (by @Eittipat in https://github.com/adaptyteam/AdaptySDK-Flutter/pull/125)setupAfterHotRestart method to Adapty and AdaptyUI which allows you to initialize the plugin after hot restart. Please check isActivated before calling this method. Please consider using this method in debug builds only to avoid any unexpected issues in release builds.Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.2.2...3.2.3
- added missing models exports Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.2.1...3.2.2
Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.2.1...3.2.2
AdaptyErrorCode change final to const
AdaptyErrorCode change final to constFull Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/3.2.0...3.2.1
🎉 Meet the Adapty Flutter SDK 3.2.0!
🎉 Meet the Adapty Flutter SDK 3.2.0!
With this version we're introducing support for the new paywall builder that offers more templates and layout flexibility. Note that:
Breaking Changes:
activate method now requires you to pass the apiKey and other parameters explicitly. Automatic activation using values from a file is no longer supported.makePurchase now returns AdaptyPurchaseResult instead of AdaptyPurchasedInfo.getProductsIntroductoryOfferEligibility(products:) has been removed. The getPaywallProducts function now returns a product object with prepopulated offer information. Consider using the getPaywallProductsWithoutDeterminingOffer(paywall:) method if you need to load products without determining offer eligibilities.paywallViewDidFinishPurchase now accepts AdaptyPurchaseResult instead of AdaptyPurchasedInfo.paywallViewDidSelectProduct now accepts String (productId) instead of AdaptyPaywallProduct.paywallViewDidCancelPurchase has been removed. Please use the purchaseResult from paywallViewDidFinishPurchase to detect purchase cancellations.Nothing published for this version
Nothing published for this version
[Android] Add parameters to activate method
activate method- Support for Flutter 3.22+
- Support for Flutter 3.22+
Support for Adapty iOS SDK 2.10.3
⚠️ Warning: In this version, we have changed the minimal supported versions:
⚠️ Warning: In this version, we have changed the minimal supported versions:
⚠️ Breaking Changes:
AdaptyStoreKit2Usage parameter in the the Adapty-Info.plist method. Adapty SDK now utilizes the StoreKit 2 method for introductory offer eligibility checks if available.[Android] fixed the incorrect format of some analytics events in rare cases
Added support for AdaptyUI 2.1.x
Full Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/2.9.1...2.9.2
[iOS] Fixed support for Swift 5.7.x (Xcode 14.0 - 14.2)
⚠️ Warning: This version relies on StoreKit 2 instead of StoreKit 1. Starting from this version, you must connect your account to Apple In-App Purchas
⚠️ Warning: This version relies on StoreKit 2 instead of StoreKit 1. Starting from this version, you must connect your account to Apple In-App Purchase API in Adapty Dashboard. Otherwise, we won't be able to make or validate purchases.
New:
fetchPolicy parameter into .getPaywall() methodloadTimeout parameter into .getPaywall() methodRead More in our documentation.
Breaking Changes:
placementId parameter has been added to the getPaywall method, replacing the previously unnamed parameter id. Read MoreAdaptyEnableUsageLogs of Adapty-Info.plist is no longer supported, since this feature is enabled by default. Read MoreAdaptyStoreKit2Usage parameter to Adapty-Info.plist, the default value will be .forIntroEligibilityCheck (this means that by default we will fetch introductory offers eligibility using StoreKit 2). Read More[Android] fixes for AdaptyUI library
[iOS] Update Adapty-iOS dependency to 2.7.0
[Android] Updated retry logic according to new PBL error.
Updated Android Adapty SDK version to 2.6.1
AdaptyPaywallProduct now has a unified structure for both systems.[Android] Support for Google Billing Library v5+. Read more
offerId property has been added to the AdaptyAccessLevel and AdaptySubscription entities in AdaptyProfile⚠️ Breaking!
AdaptyAndroidSubscriptionUpdateProrationMode to AdaptyAndroidSubscriptionUpdateReplacementMode.getProductsIntroductoryOfferEligibility. The behavior of this function depends on your Adapty SDK configuration. It will utilize StoreKit 2 if available or fallback to a legacy logic based on receipt analysis. For more detailed information, please refer to our documentation. Read moreAdaptyEligibility.unknown was replaced with .notApplicable (for products that cannot contain offers)AdaptyPaywallProduct now has a unified structure for both systemsAdaptyPrice structure. Migrate as follows:
product.price -> product.price.amountproduct.localizedPrice -> product.price.localizedStringproduct.currencyCode -> product.price.currencyCodeproduct.currencySymbol -> product.price.currencySymbolAdaptySubscriptionDetails structure. Migrate as follows:
product.subscriptionPeriod -> product.subscriptionDetails.subscriptionPeriodproduct.localizedSubscriptionPeriod -> product.subscriptionDetails.localizedSubscriptionPeriodAdaptySubscriptionPhase structure instead of AdaptyProductDiscount. Phase represents either Introductory period (product.subscriptionDetails.introductoryOffer) or Promo period (product.subscriptionDetails.promotionalOffer). Migrate as follows:
product.freeTrialPeriod -> look into paymentMode and subscriptionPeriod properties of AdaptySubscriptionPhaseproduct.localizedFreeTrialPeriod -> look into localizedSubscriptionPeriod property of AdaptySubscriptionPhaseproduct.promotionalOfferEligibility -> product.subscriptionDetails.promotionalOfferEligibilityproduct.promotionalOfferId -> product.subscriptionDetails.promotionalOfferIdproduct.variationId -> product.paywallVariationIdFull Changelog: https://github.com/adaptyteam/AdaptySDK-Flutter/compare/2.4.4...2.6.0
Added hasViewConfiguration for AdaptyPaywall object
hasViewConfiguration for AdaptyPaywall objectOne column per quarter.