In diesem Dokument wird beschrieben, wie Sie von der Google Play Billing Library (PBL) 6 oder 7 zu PBL 8 migrieren und die neuen optionalen Abofunktionen einbinden.

Eine vollständige Liste der Änderungen in Version 8.0.0 finden Sie in den Versionshinweisen.

Übersicht

PBL 8 enthält Verbesserungen an vorhandenen APIs sowie die Entfernung zuvor eingestellter APIs. Diese Version der Bibliothek enthält auch neue APIs für Einmalprodukte.

Abwärtskompatibilität für PBL-Upgrade

Wenn Sie zu PBL 8 migrieren möchten, müssen Sie einige Ihrer vorhandenen API-Referenzen in Ihrer App aktualisieren oder entfernen, wie in den Releasenotizen und später in dieser Migrationsanleitung beschrieben.

Upgrade von PBL 6 oder 7 auf PBL 8

So führen Sie ein Upgrade von PBL 6 oder 7 auf PBL 8 durch:

  1. Aktualisieren Sie die Abhängigkeitsversion der Play Billing Library in der Datei build.gradle Ihrer App.

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

  2. (Gilt nur für das Upgrade von PBL 6 auf PBL 8.) Abobezogene API-Änderungen in Ihrer App verarbeiten

    In der folgenden Tabelle sind die abobezogenen APIs aufgeführt, die in der Version 8 der Play-Richtlinien für Entwickler entfernt werden, sowie die entsprechende alternative API, die Sie in Ihrer App verwenden müssen.

    In PBL 8 wurde eine zuvor eingestellte API entfernt. Zu verwendende alternative API
    setOldSkuPurchaseToken setOldPurchaseToken
    setReplaceProrationMode setSubscriptionReplacementMode
    setReplaceSkusProrationMode setSubscriptionReplacementMode

  3. Aktualisieren Sie die Implementierung der Methode queryProductDetailsAsync.

    Die Signatur der Methode ProductDetailsResponseListener.onProductDetailsResponse wurde geändert. Daher müssen Sie Änderungen an Ihrer App für die Implementierung von queryProductDetailsAsync vornehmen. Weitere Informationen finden Sie unter Zum Kauf verfügbare Produkte anzeigen.

  4. Umgang mit den entfernten APIs

    Upgrade von

    Die in der folgenden Tabelle aufgeführten APIs werden von PBL 8 nicht mehr unterstützt. Wenn Sie in Ihrer Implementierung eine dieser entfernten APIs verwenden, finden Sie in der Tabelle die entsprechenden alternativen APIs.

    In PBL 8 wurde eine zuvor eingestellte API entfernt. Zu verwendende alternative API
    queryPurchaseHistoryAsync APIs Bisherige Käufe abfragen
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (API ohne Parameter) enablePendingPurchases(PendingPurchaseParams params)
    Die eingestellte Funktion „enablePendingPurchases()“ entspricht funktional enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()).
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync
    BillingClient.Builder.enableAlternativeBilling BillingClient.Builder.enableUserChoiceBilling
    AlternativeBillingListener UserChoiceBillingListener
    AlternativeChoiceDetails UserChoiceDetails

    Upgrade von

    In der folgenden Tabelle sind die APIs aufgeführt, die in PBL 8 entfernt werden, sowie die entsprechenden alternativen APIs, die Sie in Ihrer App verwenden müssen.

    In PBL 8 wurde eine zuvor eingestellte API entfernt. Zu verwendende alternative API
    queryPurchaseHistoryAsync APIs Bisherige Käufe abfragen
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (API ohne Parameter) enablePendingPurchases(PendingPurchaseParams params)
    Die eingestellte Funktion „enablePendingPurchases()“ entspricht funktional enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()).
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync

  5. (Empfohlen) Aktivieren Sie die automatische Dienstwiederverbindung.

    Die Play Billing Library kann versuchen, die Dienstverbindung automatisch wiederherzustellen, wenn ein API-Aufruf erfolgt, während die Verbindung zum Dienst getrennt ist. Weitere Informationen finden Sie unter Automatische Dienstwiederverbindung aktivieren.

  6. Optionale Änderungen