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 il pagamento 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 API e rimuovere alcune API dalla tua app, come descritto nelle note di rilascio e più avanti in questa guida alla migrazione.

Esegui l'upgrade da PBL 5 a PBL 7

Le sezioni seguenti descrivono come eseguire l'upgrade da PBL 5 a PBL 7.

Aggiorna 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"
}

Successivamente, aggiorna i riferimenti API come descritto nelle sezioni seguenti.

Modifica gli acquisti di abbonamenti di un utente

La Libreria Fatturazione Play 5 e 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.

Gestisci le variazioni di prezzo degli abbonamenti

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

Gestisci le modifiche alle API relative agli abbonamenti

Le API setOldSkuPurchaseToken, setReplaceProrationMode e setReplaceSkusProrationMode precedentemente ritirate sono state rimosse.

Gestisci 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.

Anche i codici SERVICE_TIMEOUT e SERVICE_UNAVAILABLE sono stati aggiornati.

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

Gestisci 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 viene spostato nello 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 ulteriori 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.

Gestisci le API di fatturazione alternativa rimosse

Rimosso: BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener e AlternativeChoiceDetails. Utilizza BillingClient.Builder.enableUserChoiceBilling() con UserChoiceBillingListener e UserChoiceDetails nel callback del listener.

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 Gestisci abbonamenti e transazioni in attesa.

Abbonamenti con rate virtuali

Consulta la guida all'integrazione degli abbonamenti a rate.

Esegui l'upgrade da PBL 6 a PBL 7

Le sezioni seguenti descrivono come eseguire l'upgrade dalla libreria PBL 6 alla libreria PBL 7.

Aggiorna 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"
}

Successivamente, aggiorna i riferimenti API come descritto nelle sezioni seguenti.

Gestisci le modifiche alle API relative agli abbonamenti

Le API setOldSkuPurchaseToken, setReplaceProrationMode e setReplaceSkusProrationMode precedentemente ritirate sono state rimosse.

Gestisci le API di fatturazione alternativa rimosse

Rimosso: BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener e AlternativeChoiceDetails. Utilizza BillingClient.Builder.enableUserChoiceBilling() con UserChoiceBillingListener e UserChoiceDetails nel callback del listener.

Modifiche facoltative

PBL 7 include due nuove API facoltative.

Supporto degli acquisti in attesa per i piani prepagati

Consulta la guida Gestisci abbonamenti e transazioni in attesa.

Abbonamenti con rate virtuali

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