Esegui la migrazione alla versione 8 della Libreria Fatturazione Google Play dalle versioni 6 o 7

Questo documento descrive come eseguire la migrazione dalla libreria Google Play Billing (PBL) 6 o 7 alla PBL 8 e come integrarla con le nuove funzionalità di abbonamento facoltative.

Per un elenco completo delle modifiche nella versione 8.0.0, consulta le note di rilascio.

Panoramica

PBL 8 contiene miglioramenti alle API esistenti e la rimozione delle API precedentemente ritirate. Questa versione della libreria include anche nuove API per i prodotti una tantum.

Compatibilità con le versioni precedenti per l'upgrade del PBL

Per eseguire la migrazione alla Libreria Fatturazione Play 8, devi aggiornare o rimuovere alcuni riferimenti API esistenti dalla tua app, come descritto nelle note di rilascio e più avanti in questa guida alla migrazione.

Eseguire l'upgrade dalla Libreria Fatturazione Play 6 o 7 alla Libreria Fatturazione Play 8

Per eseguire l'upgrade da PBL 6 o 7 a PBL 8:

  1. Aggiorna la versione della dipendenza della Libreria Fatturazione Play nel file build.gradle della tua app.

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

  2. (Valido solo per l'upgrade dalla Libreria Fatturazione Play 6 alla Libreria Fatturazione Play 8). Gestisci le modifiche all'API relative agli abbonamenti nella tua app.

    La tabella seguente elenca le API correlate agli abbonamenti rimosse in PBL 8 e l'API alternativa corrispondente che devi utilizzare nella tua app.

    API precedentemente ritirata rimossa in PBL 8 API alternativa da utilizzare
    setOldSkuPurchaseToken setOldPurchaseToken
    setReplaceProrationMode setSubscriptionReplacementMode
    setReplaceSkusProrationMode setSubscriptionReplacementMode

  3. Aggiorna l'implementazione del metodo queryProductDetailsAsync.

    È stata apportata una modifica alla firma del metodo ProductDetailsResponseListener.onProductDetailsResponse, che richiede modifiche alla tua app per l'implementazione di queryProductDetailsAsync. Per maggiori informazioni, consulta la sezione Mostrare i prodotti disponibili per l'acquisto.

  4. Gestisci le API rimosse.

    Esegui l'upgrade da

    PBL 8 non supporta più le API elencate nella tabella seguente. Se la tua implementazione utilizza una di queste API rimosse, consulta la tabella per le API alternative corrispondenti.

    API precedentemente ritirata rimossa in PBL 8 API alternativa da utilizzare
    API queryPurchaseHistoryAsync Consulta Cronologia acquisti query
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (API senza parametri) enablePendingPurchases(PendingPurchaseParams params)
    Tieni presente che la funzione enablePendingPurchases() deprecata è funzionalmente equivalente a enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()).
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync
    BillingClient.Builder.enableAlternativeBilling BillingClient.Builder.enableUserChoiceBilling
    AlternativeBillingListener UserChoiceBillingListener
    AlternativeChoiceDetails UserChoiceDetails

    Esegui l'upgrade da

    La tabella seguente elenca le API rimosse in PBL 8 e le API alternative corrispondenti che devi utilizzare nella tua app.

    API precedentemente ritirata rimossa in PBL 8 API alternativa da utilizzare
    API queryPurchaseHistoryAsync Consulta Cronologia acquisti query
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (API senza parametri) enablePendingPurchases(PendingPurchaseParams params)
    Tieni presente che la funzione enablePendingPurchases() deprecata è funzionalmente equivalente a enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()).
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync

  5. (Consigliato) Attiva la riconnessione automatica del servizio.

    La libreria Play Billing può tentare di ristabilire automaticamente la connessione al servizio se viene effettuata una chiamata API mentre il servizio è disconnesso. Per ulteriori informazioni, vedi Attivare la riconnessione automatica del servizio.

  6. Modifiche facoltative.