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 a Libreria Fatturazione Google Play 7 e come integrare le nuove funzionalità di abbonamento facoltative.

Per un elenco completo delle modifiche apportate alla versione 7.0.0, consulta le note sulla versione.

Panoramica

Libreria Fatturazione Google Play 7 migliora la gestione dei pagamenti per le funzionalità in abbonamento esistenti. Questi miglioramenti facoltativi aggiungono il supporto per i pagamenti con piani di rateizzazione e 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 Libreria Fatturazione Google Play 7 sono facoltative e gli sviluppatori non devono implementare alcuna modifica all'API per eseguire l'aggiornamento.

Per eseguire la migrazione, devi aggiornare i riferimenti delle API e rimuovere determinate API dall'app come descritto nelle note di rilascio e in questa guida alla migrazione.

Upgrade da PBL 5 a PBL 7

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

Aggiorna Libreria Fatturazione Google Play

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

dependencies {
    def billingVersion = 7.0.0

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

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

Modificare gli acquisti degli abbonamenti di un utente

La Libreria Fatturazione Play 5 e versioni precedenti utilizzava 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 ai prezzi degli abbonamenti

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

Gestire le modifiche all'API relative agli abbonamenti

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

Gestire gli errori di Libreria Fatturazione Play

Un nuovo codice NETWORK_ERROR indica problemi di 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 sospeso

La Libreria Fatturazione Play non crea più un ID ordine per gli acquisti in attesa. Per questi acquisti, l'ID ordine viene completato dopo che l'acquisto viene spostato nello stato PURCHASED. Assicurati che l'integrazione preveda un ID ordine solo al termine della transazione. Puoi continuare a utilizzare il token di acquisto per tuo riferimento.

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.

Gestire le API di fatturazione alternativa rimosse

BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener e AlternativeChoiceDetails rimossi. Gli sviluppatori dovrebbero usare BillingClient.Builder.enableUserChoiceBilling() con UserChoiceBillingListener e UserChoiceDetails nel callback del listener.

Questo aggiornamento ridenominazione delle API deprecate, senza modifiche al comportamento.

Modifiche facoltative

PBL 7 include due nuove API facoltative.

Supporta gli acquisti in attesa per i piani prepagati

Consulta la guida per la gestione degli abbonamenti e delle transazioni in attesa.

Abbonamenti a rate virtuali

Consulta la guida all'integrazione degli abbonamenti a rate.

Passare da PBL 6 a PBL 7

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

Aggiorna Libreria Fatturazione Google Play

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

dependencies {
    def billingVersion = 7.0.0

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

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

Gestire le modifiche all'API relative agli abbonamenti

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

Gestire le API di fatturazione alternativa rimosse

BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener e AlternativeChoiceDetails rimossi. Gli sviluppatori dovrebbero usare BillingClient.Builder.enableUserChoiceBilling() con UserChoiceBillingListener e UserChoiceDetails nel callback del listener.

Modifiche facoltative

PBL 7 include due nuove API facoltative.

Supporta gli acquisti in attesa per i piani prepagati

Consulta la guida per la gestione degli abbonamenti e delle transazioni in attesa.

Abbonamenti a rate virtuali

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