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

Questo documento descrive come eseguire la migrazione dalla versione 5 o 6 della Libreria Fatturazione Google Play alla Libreria Fatturazione Google Play 7 e come eseguire l'integrazione con il nuovo funzionalità di abbonamento.

Per un elenco completo delle modifiche apportate alla versione 7.0.0, consulta la release note.

Panoramica

La Libreria Fatturazione Google Play 7 migliora la gestione dei pagamenti per le funzionalità di abbonamento esistenti. Questi miglioramenti facoltativi aggiungere il supporto per i pagamenti con i piani di rateizzazione, nonché assistenza per acquisti in attesa di 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 alcuna modifica all'API per eseguire l'aggiornamento.

Per eseguire la migrazione, devi aggiornare i riferimenti API e rimuovere determinate API dell'app, come descritto nelle note di rilascio e più avanti in guida alla migrazione.

Upgrade da PBL 5 a PBL 7

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

Aggiorna Libreria Fatturazione Google Play

Aggiorna la versione della dipendenza Libreria Fatturazione Play in il file build.gradle dell'app.

dependencies {
    def billingVersion = 7.0.0

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

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

Modificare gli acquisti di abbonamenti effettuati da un utente

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

Gestire le variazioni di prezzo degli abbonamenti

L'API launchPriceConfirmationFlow deprecata in precedenza è stata rimossa. Per conoscere le alternative, consulta le variazioni di prezzo .

Gestire le modifiche all'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 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 ulteriori informazioni, vedi Gestire i codici di risposta di 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 compilato dopo il trasferimento dell'acquisto allo stato PURCHASED. Assicurati che l'integrazione preveda e un ID ordine solo al termine della transazione. Puoi comunque usare il token di acquisto per riferimento futuro.

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

Gestire le API di fatturazione alternativa rimosse

Rimosso 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 ritirate senza modifiche del 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 attesa.

Abbonamenti a rate virtuali

Consulta la guida sull'integrazione degli abbonamenti a rate.

Upgrade da PBL 6 a PBL 7

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

Aggiorna Libreria Fatturazione Google Play

Aggiorna la versione della dipendenza Libreria Fatturazione Play in il file build.gradle dell'app.

dependencies {
    def billingVersion = 7.0.0

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

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

Gestire le modifiche all'API relative agli abbonamenti

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

Gestire le API di fatturazione alternativa rimosse

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

Supporto degli acquisti in attesa per i piani prepagati

Consulta la guida Gestire gli abbonamenti e le 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.