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.
- Aggiorna
setOldSkuPurchaseToken
asetOldPurchaseToken
. - Aggiorna
setReplaceProrationMode
insetSubscriptionReplacementMode
. - Aggiorna
setReplaceSkusProrationMode
insetSubscriptionReplacementMode
.
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.
- Aggiorna
setOldSkuPurchaseToken
asetOldPurchaseToken
. - Aggiorna
setReplaceProrationMode
insetSubscriptionReplacementMode
. - Aggiorna
setReplaceSkusProrationMode
insetSubscriptionReplacementMode
.
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.