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 zu 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 und entfernt zuvor eingestellte APIs. Diese Version der Bibliothek enthält auch neue APIs für Einmalkaufprodukte.

Abwärtskompatibilität für PBL-Upgrade

Wenn Sie zur PBL 8 migrieren möchten, müssen Sie einige Ihrer vorhandenen API-Referenzen in Ihrer App aktualisieren oder entfernen, wie in den Versionshinweisen und weiter unten 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 ein Upgrade von PBL 6 auf PBL 8.) Verarbeiten Sie abobezogene API-Änderungen in Ihrer App.

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

    Zuvor verworfene API in PBL 8 entfernt Alternative API, die verwendet werden soll
    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 findest du unter Produktverfügbarkeit anzeigen.

  4. Entfernte APIs verarbeiten.

    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 verworfene API in PBL 8 entfernt Alternative API, die verwendet werden soll
    queryPurchaseHistoryAsync APIs Siehe Bisherige Käufe abfragen.
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (API ohne Parameter) enablePendingPurchases(PendingPurchaseParams params)
    Die eingestellte Methode „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 verworfene API in PBL 8 entfernt Alternative API, die verwendet werden soll
    queryPurchaseHistoryAsync APIs Siehe Bisherige Käufe abfragen.
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (API ohne Parameter) enablePendingPurchases(PendingPurchaseParams params)
    Die eingestellte Methode „enablePendingPurchases()“ entspricht funktional enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()).
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync

  5. (Empfohlen) Aktivieren Sie die automatische Wiederherstellung der Verbindung zum 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 Dienstwiederverbindung aktivieren.

  6. Optionale Änderungen.