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à facoltative degli abbonamenti.

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à degli abbonamenti esistenti. Questi miglioramenti facoltativi aggiungono il supporto per i pagamenti con piani di rateizzazione nonché il supporto per gli acquisti in attesa per gli abbonamenti prepagati.

Upgrade della Libreria Fatturazione Play compatibile con le versioni precedenti

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

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

Eseguire l'upgrade da PBL 5 a PBL 7

Le sezioni seguenti descrivono 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"
}

Aggiorna quindi i riferimenti 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 variazioni di prezzo dell'abbonamento

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

Gestire le modifiche all'API relative agli abbonamenti

Le API setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode precedentemente deprecate 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 di Google Play.

Sono stati aggiornati anche i codici SERVICE_TIMEOUT e SERVICE_UNAVAILABLE.

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

Gestire le transazioni in attesa

La Play Billing Library non crea più un ID ordine per gli acquisti in attesa. Per questi acquisti, l'ID ordine viene inserito dopo che l'acquisto è stato spostato nello stato PURCHASED. Assicurati che l'integrazione preveda un ID ordine solo al termine della transazione. Puoi comunque utilizzare il token di acquisto per riferimento futuro.

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

Gestire le API di fatturazione alternativa rimosse

BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener, e AlternativeChoiceDetails sono stati rimossi. Gli sviluppatori dovrebbero utilizzare BillingClient.Builder.enableUserChoiceBilling() con UserChoiceBillingListener e UserChoiceDetails nel callback dell'ascoltatore.

Questo aggiornamento consiste nella ridenominazione delle API deprecate senza modifiche al comportamento.

Modifiche facoltative

PBL 7 include due nuove API facoltative.

Supporto degli acquisti in attesa per i piani prepagati

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

Abbonamenti con rate virtuali

Consulta la guida all'integrazione degli abbonamenti a rate.

Eseguire l'upgrade da PBL 6 a PBL 7

Le sezioni seguenti descrivono 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"
}

Aggiorna quindi i riferimenti API come descritto nelle sezioni seguenti.

Gestire le modifiche all'API relative agli abbonamenti

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

Gestire le API di fatturazione alternativa rimosse

BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener e AlternativeChoiceDetails sono stati rimossi. Gli sviluppatori dovrebbero utilizzare BillingClient.Builder.enableUserChoiceBilling() con UserChoiceBillingListener e UserChoiceDetails nel callback dell'ascoltatore.

Modifiche facoltative

PBL 7 include due nuove API facoltative.

Supporto degli acquisti in sospeso per i piani prepagati

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

Abbonamenti con rate virtuali

Consulta la guida all'integrazione degli abbonamenti a rate per informazioni su come integrare queste modifiche nella tua app.