Migration von Version 6 oder 7 zur Google Play Billing Library 8

In diesem Dokument wird beschrieben, wie Sie von der Google Play Billing Library (PBL) 6 oder 7 zur PBL 8 migrieren und die neuen optionalen Abo-Funktionen 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 von zuvor verworfenen APIs. Diese Version der Bibliothek enthält auch neue APIs für Einmalprodukte.

Abwärtskompatibilität für PBL-Upgrade

Für die Migration zu PBL 8 müssen Sie einige Ihrer vorhandenen API-Referenzen aus Ihrer App aktualisieren oder entfernen, wie in den Versionshinweisen 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 Version der Play Billing Library-Abhängigkeit 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. Abo-bezogene API-Änderungen in Ihrer App verarbeiten

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

    Zuvor eingestellte API in PBL 8 entfernt Alternative API
    setOldSkuPurchaseToken setOldPurchaseToken
    setReplaceProrationMode setSubscriptionReplacementMode
    setReplaceSkusProrationMode setSubscriptionReplacementMode

  3. Aktualisieren Sie die Implementierung der Methode queryProductDetailsAsync.

    Die Signatur der Methode ProductDetailsResponseListener.onProductDetailsResponse hat sich geändert. Daher sind Änderungen in Ihrer App für die Implementierung von queryProductDetailsAsync erforderlich. Weitere Informationen finden Sie unter Zum Kauf verfügbare Produkte anzeigen.

  4. Umgang mit den entfernten APIs

    Upgrade von

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

    Zuvor eingestellte API in PBL 8 entfernt Alternative API
    queryPurchaseHistoryAsync-APIs Abfrageverlauf
    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 wurden, sowie die entsprechenden alternativen APIs, die Sie in Ihrer App verwenden müssen.

    Zuvor eingestellte API in PBL 8 entfernt Alternative API
    queryPurchaseHistoryAsync-APIs Abfrageverlauf
    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 Wiederverbindung mit dem Dienst.

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

  6. Optionale Änderungen.