Eseguire la migrazione alla Libreria Fatturazione Google Play 7 dalla versione 5 o 6

Questo documento descrive come eseguire la migrazione dalla Libreria Fatturazione Google Play 5 o 6 alla Libreria Fatturazione Google Play 7 e come eseguire l'integrazione con le nuove funzionalità di abbonamento facoltative.

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

Panoramica

La Libreria Fatturazione Google Play 7 migliora la gestione dei pagamenti per le funzionalità di abbonamento esistenti. Questi miglioramenti facoltativi aggiungono il supporto per i pagamenti con piani rateali e per gli acquisti in attesa per gli abbonamenti prepagati.

Upgrade della Libreria Fatturazione Play compatibile con le versioni precedenti

Tutte le nuove API della Libreria Fatturazione Google Play 7 sono facoltative e gli sviluppatori non devono implementare modifiche alle API per eseguire l'aggiornamento.

Per eseguire la migrazione, devi aggiornare i riferimenti alle API e rimuovere alcune API dalla tua app, come descritto nelle note di rilascio e più avanti in questa guida alla migrazione.

Upgrade da PBL 5 a PBL 7

Nelle sezioni seguenti viene descritto come eseguire l'upgrade da PBL 5 a PBL 7.

Aggiornare la Libreria Fatturazione Google Play

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

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

Poi, aggiorna i riferimenti alle API come descritto nelle sezioni seguenti.

Modificare gli acquisti di abbonamenti di un utente

La Libreria Fatturazione Play 5 e le versioni precedenti utilizzavano ProrationMode per applicare modifiche agli acquisti di abbonamenti di un utente, ad esempio upgrade o downgrade. Questa API è stata rimossa e sostituita con ReplacementMode.

Gestire le modifiche del prezzo dell'abbonamento

L'API launchPriceConfirmationFlow precedentemente deprecata è stata rimossa. Per le alternative, consulta la guida alle modifiche dei prezzi.

Gestire le modifiche delle API relative agli abbonamenti

Le API precedentemente deprecate setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode sono state rimosse.

Gestire gli errori della Libreria Fatturazione Play

Un nuovo codice NETWORK_ERROR indica problemi con la connessione di rete tra il dispositivo dell'utente e il sistema Google Play.

Sono stati aggiornati anche i codici SERVICE_TIMEOUT e SERVICE_UNAVAILABLE.

Per maggiori informazioni, consulta Gestire i codici di risposta BillingResult.

Gestire le transazioni in attesa

La Libreria Fatturazione Play non crea più un ID ordine per gli acquisti in attesa. Per questi acquisti, l'ID ordine viene compilato dopo che l'acquisto è passato allo stato PURCHASED. Assicurati che l'integrazione preveda un ID ordine solo dopo che una transazione è stata completata. Puoi comunque utilizzare il token di acquisto per i tuoi record.

Per maggiori informazioni sulla gestione degli acquisti in attesa, consulta la guida all'integrazione della Libreria Fatturazione Play e la guida alla gestione del ciclo di vita degli acquisti.

Gestire le API di fatturazione alternativa rimosse

Sono stati rimossi BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener, e AlternativeChoiceDetails. Gli sviluppatori devono utilizzare BillingClient.Builder.enableUserChoiceBilling() con UserChoiceBillingListener e UserChoiceDetails nel callback del listener.

Questo aggiornamento è una ridenominazione delle API deprecate senza modifiche al comportamento.

Modifiche facoltative

PBL 7 include due nuove API facoltative.

Supportare gli acquisti in attesa per i piani prepagati

Consulta la guida Gestire gli abbonamenti e le transazioni in attesa.

Abbonamenti con rate virtuali

Consulta la guida all'integrazione degli abbonamenti con rate.

Upgrade da PBL 6 a PBL 7

Nelle sezioni seguenti viene descritto come eseguire l'upgrade da PBL 6 a PBL 7.

Aggiornare la Libreria Fatturazione Google Play

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

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

Poi, aggiorna i riferimenti alle API come descritto nelle sezioni seguenti.

Gestire le modifiche delle API relative agli abbonamenti

Le API precedentemente deprecate setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode sono state rimosse.

Gestire le API di fatturazione alternativa rimosse

Sono stati rimossi BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener e AlternativeChoiceDetails. Gli sviluppatori devono utilizzare BillingClient.Builder.enableUserChoiceBilling() con UserChoiceBillingListener e UserChoiceDetails nel callback del listener.

Modifiche facoltative

PBL 7 include due nuove API facoltative.

Supportare gli acquisti in attesa per i piani prepagati

Consulta la guida Gestire gli abbonamenti e le transazioni in attesa.

Abbonamenti con rate virtuali

Per informazioni su come integrare queste modifiche nella tua app, consulta la guida all'integrazione degli abbonamenti con rate Installment Subscriptions Integration per.