從 Google Play 帳款服務程式庫第 6 或第 7 版改用第 8 版

本文說明如何從 Google Play Billing Library (PBL) 6 或 7 遷移至 PBL 8，以及如何整合新的選用訂閱功能。

如需 8.0.0 版的完整異動清單，請參閱版本資訊。

總覽

PBL 8 改善了現有 API，並移除先前淘汰的 API。這個版本的程式庫也包含適用於單次產品的新 API。

PBL 升級的回溯相容性

如要遷移至 PBL 8，您需要更新或移除應用程式中的部分現有 API 參照，詳情請參閱版本資訊和本遷移指南後續章節。

從 PBL 6 或 7 升級至 PBL 8

如要從 PBL 6 或 7 升級至 PBL 8，請按照下列步驟操作：

  1. 在應用程式的 build.gradle 檔案中，更新 Play Billing Library 依附元件版本。

    dependencies {
   def billingVersion = 8.0.0
   implementation "com.android.billingclient:billing:$billingVersion"
}

  2. (僅適用於從 PBL 6 升級至 PBL 8)。在應用程式中處理訂閱相關 API 異動。

    下表列出 PBL 8 移除的訂閱相關 API，以及應用程式必須使用的對應替代 API。

    PBL 8 移除先前淘汰的 API 可使用的替代 API
    setOldSkuPurchaseToken setOldPurchaseToken
    setReplaceProrationMode setSubscriptionReplacementMode
    setReplaceSkusProrationMode setSubscriptionReplacementMode

  3. 更新 queryProductDetailsAsync 方法的實作。

    ProductDetailsResponseListener.onProductDetailsResponse 方法的簽章有所變更，因此您必須在應用程式中變更 queryProductDetailsAsync 實作。詳情請參閱「顯示可購買的產品」。

  4. 處理已移除的 API。

    升級

    PBL 8 不再支援下表列出的 API。如果您的實作項目使用任何已移除的 API，請參閱表格，瞭解對應的替代 API。

    PBL 8 移除先前淘汰的 API 可使用的替代 API
    queryPurchaseHistoryAsync API 請參閱「查詢購買記錄」
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (不含參數的 API) enablePendingPurchases(PendingPurchaseParams params)
    請注意，已淘汰的 enablePendingPurchases() 在功能上等同於 enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build())。
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync
    BillingClient.Builder.enableAlternativeBilling BillingClient.Builder.enableUserChoiceBilling
    AlternativeBillingListener UserChoiceBillingListener
    AlternativeChoiceDetails UserChoiceDetails

    升級自

    下表列出 PBL 8 中移除的 API，以及您必須在應用程式中使用的對應替代 API。

    PBL 8 移除先前淘汰的 API 可使用的替代 API
    queryPurchaseHistoryAsync API 請參閱「查詢購買記錄」
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (不含參數的 API) enablePendingPurchases(PendingPurchaseParams params)
    請注意，已淘汰的 enablePendingPurchases() 在功能上等同於 enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build())。
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync

  5. (建議) 啟用自動重新連線服務。

    如果服務中斷連線時發出 API 呼叫，Play Billing Library 會嘗試自動重新建立服務連線。詳情請參閱「啟用自動服務重新連線功能」。

  6. 選用變更。