从 Google Play 结算库版本 5 或 6 迁移到版本 7

本文档介绍了如何从 Google Play 结算库版本 5 或 6 迁移到 Google Play 结算库版本 7，以及如何与新的可选订阅功能集成。

如需查看版本 7.0.0 的完整变更列表，请参阅版本说明。

概览

Google Play 结算库 7 改进了现有订阅功能的付款处理方式。这些可选的改进增加了对采用分期付款方案付款的支持，以及对预付费订阅的待处理购买交易的支持。

向后兼容的 Play 结算库升级

所有新的 Google Play 结算库版本 7 API 都是可选的，开发者无需实现任何 API 更改即可更新。

如需进行迁移，您需要按照版本说明和本迁移指南后面部分所述，更新 API 引用并从应用中移除某些 API。

从 PBL 5 升级到 PBL 7

以下部分介绍了如何从 PBL 5 升级到 PBL 7。

更新 Google Play 结算库

在应用的 build.gradle 文件中更新 Play 结算库依赖项版本。

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

接下来，按照下面几部分中的说明更新您的 API 引用。

更改用户的订阅购买交易

Play 结算库 5 及更低版本使用 ProrationMode 将更改应用于用户的订阅购买交易，例如升级或降级。此 API 已被移除，取而代之的是 ReplacementMode。

处理订阅价格变动

移除了之前废弃的 launchPriceConfirmationFlow API。如需了解替代方案，请参阅价格变动指南。

处理与订阅相关的 API 变更

移除了之前废弃的 API setOldSkuPurchaseToken、setReplaceProrationMode 和 setReplaceSkusProrationMode。

处理 Play 结算库错误

新的 NETWORK_ERROR 代码表示用户设备和 Google Play 系统之间的网络连接存在问题。

SERVICE_TIMEOUT 和 SERVICE_UNAVAILABLE 代码也已更新。

如需了解详情，请参阅处理 BillingResult 响应代码。

处理待处理的交易

Play 结算库不再为待处理的购买交易创建订单 ID。对于这类购买交易，系统会在购买交易变为 PURCHASED 状态后填充订单 ID。确保您的集成仅在交易完全完成后才预期订单 ID。您仍然可以使用购买令牌作为记录。

如需详细了解如何处理待处理的购买交易，请参阅 Play 结算库集成指南和购买生命周期管理指南。

处理已移除的备选结算系统 API

移除了 BillingClient.Builder.enableAlternativeBilling、AlternativeBillingListener 和 AlternativeChoiceDetails。开发者应改为在监听器回调中将 BillingClient.Builder.enableUserChoiceBilling() 与 UserChoiceBillingListener 和 UserChoiceDetails 结合使用。

此更新是对已废弃 API 的重命名，没有任何行为变更。

可选更改

PBL 7 包含两个新的可选 API。

支持预付费方案的待处理购买

请参阅处理订阅和待处理交易指南。

虚拟分期付款订阅

请参阅分期付款订阅集成指南。

从 PBL 6 升级到 PBL 7

以下部分介绍了如何从 PBL 6 升级到 PBL 7。

更新 Google Play 结算库

在应用的 build.gradle 文件中更新 Play 结算库依赖项版本。

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

接下来，按照下面几部分中的说明更新您的 API 引用。

处理与订阅相关的 API 变更

移除了之前废弃的 API setOldSkuPurchaseToken、setReplaceProrationMode 和 setReplaceSkusProrationMode。

处理已移除的备选结算系统 API

移除了 BillingClient.Builder.enableAlternativeBilling、AlternativeBillingListener 和 AlternativeChoiceDetails。开发者应改为在监听器回调中将 BillingClient.Builder.enableUserChoiceBilling() 与 UserChoiceBillingListener 和 UserChoiceDetails 结合使用。

可选更改

PBL 7 包含两个新的可选 API。

支持预付费方案的待处理购买

请参阅处理订阅和待处理交易指南。

虚拟分期付款订阅

如需了解如何将这些变更集成到您的应用中，请参阅分期付款订阅集成指南。