提醒：到 2024 年 8 月 31 日，所有新应用和对现有应用的更新都必须使用结算库版本 6 或更高版本。如果您需要更多时间更新您的应用，您可以申请延期至 2024 年 11 月 1 日。了解更多。

从版本 5 或 6 迁移到 Google Play 结算库 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 已被删除。

将 setOldSkuPurchaseToken 更新为 setOldPurchaseToken。
将 setReplaceProrationMode 更新为 setSubscriptionReplacementMode。
将 setReplaceSkusProrationMode 更新为 setSubscriptionReplacementMode。

处理 Play Billing 库错误

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

还更新了 SERVICE_TIMEOUT 和 SERVICE_UNAVAILABLE 代码。

有关更多信息，请参阅处理 BillingResult 响应代码。

处理挂起的交易

Play Billing 库不再为挂起的购买创建订单 ID。对于这些购买，订单 ID 会在购买状态变为 PURCHASED 后填充。请确保您的集成仅在交易完全完成后才期望订单 ID。您仍然可以使用购买令牌进行记录。

有关处理挂起购买的更多信息，请参阅 Play Billing 库的集成指南和购买生命周期管理指南。

处理已移除的替代计费 API

已移除 BillingClient.Builder.enableAlternativeBilling、AlternativeBillingListener 和 AlternativeChoiceDetails。开发人员应改用 BillingClient.Builder.enableUserChoiceBilling()，并在侦听器回调中使用 UserChoiceBillingListener 和 UserChoiceDetails。

此更新是对已弃用 API 的重命名，行为没有变化。

可选更改

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

支持预付费计划的挂起购买

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

虚拟分期付款订阅

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

从 PBL 6 升级到 PBL 7

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