Migration guide to Adapty SDK v.3.x or later
Adapty SDK v.3.0 brings support for the new exciting Adapty Paywall Builder, the new version of the no-code user-friendly tool to create paywalls. With its maximum flexibility and rich design capabilities, your paywalls will become most effective and profitable.
Upgrade process includes
- Upgrading to Adapty SDK v3.x (instructions differ for iOS and Android).
- Migrating your existing paywalls to the new Paywall Builder.
Upgrading to Adapty SDK v3.x
- For iOS
- For Android
Please note that the AdaptyUI library is deprecated and is now included as part of AdaptySDK.
Reinstall Adapty SDK v3.x via Swift Package Manager
- Delete AdaptyUI SDK package dependency from your project, you won't need it anymore.
- Even though you have it already, you'll need to re-add the Adapty SDK dependency. For this, in Xcode, open File -> Add Package Dependency.... Please note the way to add package dependencies can differ in XCode versions. Refer to XCode documentation if necessary.
- Enter the repository URL
https://github.com/adaptyteam/AdaptySDK-iOS.git
- Choose the version, and click the Add package button.
- Choose the modules you need:
- Adapty is the mandatory module
- AdaptyUI is an optional module you need if you plan to use the Adapty Paywall Builder.
- Xcode will add the package dependency to your project, and you can import it. For this, in the Choose Package Products window, click the Add package button once again. The package will appear in the Packages list.
Reinstall Adapty SDK v3.x via CocoaPods
-
Add Adapty to your
Podfile
. Choose the modules you need:- Adapty is the mandatory module.
- AdaptyUI is an optional module you need if you plan to use the Adapty Paywall Builder.
-
Podfile
pod 'Adapty', '~> 3.0.1'
pod 'AdaptyUI', '~> 3.0.1' # optional module needed only for Paywall Builder -
Run:
Shellpod install
This creates a .xcworkspace
file for your app. Use this file for all future development of your application.
Activate Adapty and AdaptyUI SDK modules. Before v3.0, you did not activate AdaptyUI, remember to add AdaptyUI activation. Parameters are not changes, so keep them as is.
- Swift
- SwiftUI
// In your AppDelegate class:
import Adapty
import AdaptyUI // Only if you are going to use AdaptyUI
let configurationBuilder =
Adapty.Configuration
.Builder(withAPIKey: "PUBLIC_SDK_KEY")
.with(observerMode: false)
.with(customerUserId: "YOUR_USER_ID")
.with(idfaCollectionDisabled: false)
.with(ipAddressCollectionDisabled: false)
Adapty.activate(with: configurationBuilder) { error in
// handle the error
}
// Only if you are going to use AdaptyUI
AdaptyUI.activate()
import Adapty
import AdaptyUI // Only if you are going to use AdaptyUI
@main
struct SampleApp: App {
init()
let configurationBuilder =
Adapty.Configuration
.Builder(withAPIKey: "PUBLIC_SDK_KEY")
.with(observerMode: false) // optional
.with(customerUserId: "YOUR_USER_ID") // optional
.with(idfaCollectionDisabled: false) // optional
.with(ipAddressCollectionDisabled: false) // optional
Adapty.activate(with: configurationBuilder) { error in
// handle the error
}
// Only if you are going to use AdaptyUI
AdaptyUI.activate()
}
var body: some Scene {
WindowGroup {
ContentView()
}
}
}
Adapty SDKs are delivered as a BoM (Bill of Materials), ensuring that the Adapty SDK and AdaptyUI SDK versions in your app remain consistent.
To migrate to v3.0, update your code as follows:
- module-level build.gradle
- module-level build.gradle.kts
- version catalog
dependencies {
...
- implementation 'io.adapty:android-sdk:2.11.5'
- implementation 'io.adapty:android-ui:2.11.3'
+ implementation platform('io.adapty:adapty-bom:3.0.1')
+ implementation 'io.adapty:android-sdk'
+ implementation 'io.adapty:android-ui'
}
dependencies {
...
- implementation("io.adapty:android-sdk:2.11.5")
- implementation("io.adapty:android-ui:2.11.3")
+ implementation(platform("io.adapty:adapty-bom:3.0.1"))
+ implementation("io.adapty:android-sdk")
+ implementation("io.adapty:android-ui")
}
//libs.versions.toml
[versions]
..
- adapty = "2.11.5"
- adaptyUi = "2.11.3"
+ adaptyBom = "3.0.1"
[libraries]
..
- adapty = { group = "io.adapty", name = "android-sdk", version.ref = "adapty" }
- adapty-ui = { group = "io.adapty", name = "android-ui", version.ref = "adaptyUi" }
+ adapty-bom = { module = "io.adapty:adapty-bom", version.ref = "adaptyBom" }
+ adapty = { module = "io.adapty:android-sdk" }
+ adapty-ui = { module = "io.adapty:android-ui" }
//module-level build.gradle.kts
dependencies {
...
+ implementation(libs.adapty.bom)
implementation(libs.adapty)
implementation(libs.adapty.ui)
}
Migrate your paywalls to new Paywall Builder
Starting with Adapty SDK v3.x, legacy Paywall Builder paywalls are no longer supported. Migrate your existing legacy Paywall Builder paywalls to the new Paywall Builder, one at a time. During this migration, Adapty will create a new version of each paywall that is compatible with the updated Paywall Builder. The old version, compatible with the legacy Paywall Builder, will remain unchanged, so users with app versions using Adapty SDK v2.x or earlier will still see their paywalls as before.
Paywalls designed without using a Paywall Builder are not affected.