迁移 Adapty Android SDK 至 v3.0

Adapty SDK v3.0 带来了重大改进，在迁移之前，请务必了解以下关键变更。

更换弃用方法

activateAdapty → Adapty.activate

activateAdapty 函数已被弃用，请改用 Adapty.activate。

override fun onCreate() {
    super.onCreate()
    Adapty.activate(
        applicationContext,
        AdaptyConfig.Builder("PUBLIC_SDK_KEY")
            .withObserverMode(false)
            .withCustomerUserId(customerUserId)
            .withIpAddressCollectionDisabled(false)
            .build()
    )
}

override fun onCreate() {
    super.onCreate()
    Adapty.activate(applicationContext, "PUBLIC_SDK_KEY", observerMode = false, customerUserId = "YOUR_USER_ID")
}

getPaywalls → getPaywall

getPaywalls 函数已被弃用，请改用 getPaywall。

Adapty.getPaywall("YOUR_PLACEMENT_ID", locale = "en") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val paywall = result.value
            // 使用付费墙
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // 处理错误
        }
    }
}

Adapty.getPaywalls(forceUpdate = false) { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val paywalls = result.value.paywalls
            // 使用付费墙
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // 处理错误
        }
    }
}

getPaywallProducts → getPaywallProducts

getPaywallProducts 函数签名已更新。

Adapty.getPaywallProducts(paywall) { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val products = result.value
            // 使用产品
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // 处理错误
        }
    }
}

Adapty.getPaywallProducts(paywall) { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val products = result.value
            // 使用产品
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // 处理错误
        }
    }
}

更新后的模型

AdaptyPaywall

AdaptyPaywall 模型已更新，包含以下变更：

属性	v2.x	v3.0
`name`	已弃用	已移除
`variationId`	保留	保留
`revision`	保留	保留
`isPromo`	已弃用	已移除

AdaptyProduct

AdaptyProduct 模型已更新，包含以下变更：

属性	v2.x	v3.0
`variationId`	保留	已移除（移至 `AdaptyPaywall`）
`paywallName`	保留	已移除
`paywallABTestName`	保留	已移除

移除的功能

以下功能已在 v3.0 中移除：

Promo campaigns：不再支持促销活动功能
getPromo：getPromo 方法已移除
setExternalAnalyticsEnabled：此方法已移除，请参阅分析集成文档了解替代方案

迁移步骤

将 build.gradle 中的 SDK 版本更新至 3.0.0
将所有 activateAdapty 调用替换为 Adapty.activate，并使用新的 AdaptyConfig.Builder
将所有 getPaywalls 调用替换为 getPaywall，并传入版位 ID
移除所有对已弃用属性的引用
测试所有购买流程，确保功能正常

如需获取完整的迁移支持，请联系 Adapty 支持团队。 Adapty SDK v3.0 带来了全新的 Adapty 付费墙编辑工具，这是用于创建付费墙的全新无代码工具，操作简单、功能强大。凭借其极高的灵活性和丰富的设计能力，你的付费墙将变得更加高效、更具盈利潜力。

Adapty SDK 以 BoM（Bill of Materials）方式分发，确保应用中 Adapty SDK 与 AdaptyUI SDK 的版本始终保持一致。

如需迁移至 v3.0，请按以下步骤更新代码：

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.4')
+   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.4"))
+   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.4"

[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)
}