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 wie Sie die neuen optionalen Abo-Funktionen einbinden.

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

Übersicht

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

Abwärtskompatibilität für das PBL-Upgrade

Wenn Sie zu PBL 8 migrieren möchten, müssen Sie einige Ihrer vorhandenen API Verweise in Ihrer App aktualisieren oder entfernen. Weitere Informationen finden Sie in den Versionshinweisen und weiter unten in diesem Migrationsleitfaden.

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) Behandeln Sie die API-Änderungen im Zusammenhang mit Abos in Ihrer App.

    In der folgenden Tabelle sind die APIs im Zusammenhang mit Abos aufgeführt, die in PBL 8 entfernt wurden, sowie die entsprechende alternative API, die Sie in Ihrer App verwenden müssen.

    Zuvor verworfene API, die in PBL 8 entfernt wurde Alternative API
    setOldSkuPurchaseToken setOldPurchaseToken
    setReplaceProrationMode setSubscriptionReplacementMode
    setReplaceSkusProrationMode setSubscriptionReplacementMode

  3. Aktualisieren Sie die Implementierung der queryProductDetailsAsync Methode.

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

  4. Behandeln Sie die entfernten APIs.

    Upgrade von

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

    Zuvor verworfene API, die in PBL 8 entfernt wurde Alternative API
    queryPurchaseHistoryAsync-APIs Kaufverlauf abfragen
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (API ohne Parameter) enablePendingPurchases(PendingPurchaseParams params)
    Beachten Sie, dass die verworfene API „enablePendingPurchases()“ funktional identisch ist mit 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, die in PBL 8 entfernt wurde Alternative API
    queryPurchaseHistoryAsync-APIs Kaufverlauf abfragen
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (API ohne Parameter) enablePendingPurchases(PendingPurchaseParams params)
    Beachten Sie, dass die verworfene API „enablePendingPurchases()“ funktional identisch ist mit 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 die Verbindung getrennt ist. Weitere Informationen finden Sie unter Automatische Wiederverbindung mit dem Dienst aktivieren.

  6. Optionale Änderungen.