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 Fatturazione Google Play (PBL) 6 o 7 alla PBL 8 e come eseguire l'integrazione con le nuove funzionalità di abbonamento facoltative.

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

Panoramica

La 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 della PBL

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

Eseguire l'upgrade dalla PBL 6 o 7 alla PBL 8

Per eseguire l'upgrade dalla PBL 6 o 7 alla 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. (Applicabile solo per l'upgrade dalla PBL 6 alla PBL 8). Gestisci le modifiche alle API correlate agli abbonamenti nella tua app.

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

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

  3. Aggiorna l'implementazione del queryProductDetailsAsync metodo.

    La firma del metodo ProductDetailsResponseListener.onProductDetailsResponse è stata modificata, il che richiede modifiche alla tua app per l'implementazione queryProductDetailsAsync. Per maggiori informazioni, consulta la sezione Mostrare i prodotti disponibili per l'acquisto.

  4. Gestisci le API rimosse.

    Eseguire l'upgrade da

    La 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 trovare le API alternative corrispondenti.

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

    Eseguire l'upgrade da

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

    API precedentemente ritirata rimossa nella PBL 8 API alternativa da utilizzare
    API queryPurchaseHistoryAsync Consulta Eseguire query sulla cronologia acquisti
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (API senza parametri) enablePendingPurchases(PendingPurchaseParams params)
    Tieni presente che l'API enablePendingPurchases() ritirata è funzionalmente equivalente a enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()).
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync

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

    La Libreria Fatturazione Play può tentare di ristabilire automaticamente la connessione al servizio se viene effettuata una chiamata API mentre il servizio è disconnesso. Per maggiori informazioni, consulta la sezione Abilitare la riconnessione automatica del servizio.

  6. Modifiche facoltative.