迁移指南
迁移到新的计费系统不应令人头疼。无论你是从竞争对手处迁移，还是从旧版 Aptoide 方案升级，这些指南都会提供方法、监听器和逻辑的清晰映射，帮助你尽快在新版 Aptoide Billing SDK 上运行起来。
新版 SDK 采用现代化架构设计，与行业标准高度对齐，使大多数 Android 开发者的切换过程更加直观。
✨
为什么要迁移到最新的 Aptoide 或 AppCoins Billing SDK
- 原生底部弹出式结账 — 用户在你的应用内即可购买，无需安装 Wallet，从而提高支付转化率。
- 欺诈减少 UI — 阻止流程中途的错误取消。
- 16 KB 页面大小支持 — 较新的 Android 设备兼容性所必需。
选择你的迁移路径
在下表中找到你当前的设置，查看推荐的目标 SDK、预计工作量，以及相关指南或文档的直接链接。
| 当前设置 | 推荐目标 | 工作量 | 涉及内容 | 指南 |
|---|---|---|---|---|
低于 1.2.0 的 Aptoide Billing SDK（com.aptoide:android-aptoide-billing） | Aptoide Billing SDK 1.+（com.aptoide:android-aptoide-billing） | 约 5 分钟 | 直接替换依赖项版本号 — 无需更改 API。 | 发行说明 |
高于 0.7.3.0 且低于 0.10 的 AppCoins SDK（io.catappult:android-appcoins-billing） | AppCoins SDK 0.10.+（io.catappult:android-appcoins-billing） | 约 5 分钟 | 直接替换依赖项版本号 — 无需更改 API。 | 发行说明 |
Google Play Billing SDK（com.android.billingclient:billing） | Aptoide Billing SDK 1.+（com.aptoide:android-aptoide-billing） | 约 10 分钟 （使用 AI 提示词时） | 映射 BillingClient 监听器，并将 Google 专属依赖项替换为 Aptoide 的等效项。API 几乎一一对应。 | 迁移指南 · AI 提示词 |
低于 0.7.3.0 的 旧版 AppCoins SDK（io.catappult:android-appcoins-billing） | AppCoins SDK 0.10.+（io.catappult:android-appcoins-billing）或 Aptoide Billing SDK 1.+（com.aptoide:android-aptoide-billing） | 约 30 分钟 | 从旧版流程迁移到回调驱动的原生实现以及更新的 Aptoide Connect 后端 API。 | 迁移指南 |
| 一步支付（OSP） | Aptoide Billing SDK 1.+（com.aptoide:android-aptoide-billing） | 约 1 小时 | 用直接连接到 Aptoide Wallet 的原生 SDK 客户端替换通过 URL 启动的网页支付。 | 迁移指南 |
注意： AppCoins SDK（
io.catappult:android-appcoins-billing）是受维护的旧版产品线，而 Aptoide Billing SDK（com.aptoide:android-aptoide-billing）是面向新集成和长期集成的现代化推荐 SDK。如果时间允许，迁移到 Aptoide Billing SDK1.+是最佳的长期选择。
可用的迁移路径
根据你当前的实现，选择与你的起点相匹配的指南：
从 Google Play Billing 迁移
对于之前集成过 Google Billing SDK 的开发者，Aptoide Billing SDK 遵循与 Google Play Billing SDK 非常相似的模式，本指南将帮助你顺利完成迁移。
- 重点： 映射
BillingClient监听器，并将 Google 专属依赖项替换为 Aptoide 的等效项。
从旧版 AppCoins SDK 迁移
适用于使用旧版 AppCoins 集成的开发者。本次迁移的重点是从旧版 SDK 流程迁移到更健壮的、回调驱动的原生实现。
- 重点： 安全性改进、更简便的集成、功能增强，以及迁移到更新的 Aptoide Connect 后端 API。
从 OSP 集成迁移
如果你之前使用 一步支付（OSP） 的网页流程，本指南将帮助你把这些交互封装为原生 Android 体验。
- 重点： 用高性能原生 SDK 替换使用 URL 手动启动的支付。
通用迁移技巧
- 双重集成： 你可以通过在代码中使用简单的 flavor 或"Provider"模式，让现有的 Billing SDK 与 Aptoide SDK 并存。
- 查看我们的 Aptoide Diceroll SDK 示例，以深入了解如何实现这一点。
- 在沙盒中测试： 在推送到生产轨道之前，请始终使用沙盒环境验证你的迁移。