Ce document explique comment effectuer une migration depuis la bibliothèque Google Play Billing 5 ou 6 à la bibliothèque Google Play Billing 7 et comment intégrer le nouveau de Google Cloud.
Pour obtenir la liste complète des modifications apportées à la version 7.0.0, reportez-vous à la version commentaires.
Présentation
La Bibliothèque Google Play Billing 7 améliore la gestion des paiements pour les fonctionnalités d'abonnement existantes. Ces améliorations facultatives ajouter la prise en charge du paiement avec des plans de versement ainsi que la prise en charge des achats en attente pour les abonnements prépayés.
Mise à niveau de la bibliothèque Play Billing rétrocompatible
Toutes les nouvelles API de la bibliothèque Google Play Billing 7 sont facultatives. les développeurs n'ont pas besoin de modifier l'API pour effectuer la mise à jour.
Pour procéder à la migration, vous devez mettre à jour les références des API et supprimer certaines API de votre application, comme décrit dans les notes de version et plus loin dans ce document guide de migration.
Passer de PBL 5 à PBL 7
Les sections suivantes décrivent comment passer de PBL 5 à PBL 7.
Mettre à jour la Bibliothèque Google Play Billing
Mettre à jour la version de la dépendance de la bibliothèque Play Billing dans
le fichier build.gradle de votre application.
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
Ensuite, mettez à jour vos références d'API comme décrit dans les sections suivantes.
Modifier les achats d'abonnements d'un utilisateur
Bibliothèque Play Billing 5 et versions antérieures utilisées ProrationMode
pour appliquer des modifications aux achats d'abonnements d'un utilisateur, telles que les mises à niveau
ou à des rétrogradations. Cette API a été supprimée et remplacée par
ReplacementMode
Gérer les changements de prix des abonnements
L'API launchPriceConfirmationFlow, qui était obsolète, a été supprimée.
Pour découvrir d'autres options, consultez le Guide des changements de prix.
Gérer les modifications de l'API liées aux abonnements
Les API setOldSkuPurchaseToken, qui étaient obsolètes,
Suppression de setReplaceProrationMode et setReplaceSkusProrationMode.
- Remplacez
setOldSkuPurchaseTokenparsetOldPurchaseToken. - Remplacer
setReplaceProrationModeparsetSubscriptionReplacementMode - Remplacer
setReplaceSkusProrationModeparsetSubscriptionReplacementMode
Gérer les erreurs de la bibliothèque Play Billing
Un nouveau code NETWORK_ERROR indique des problèmes de connexion réseau
entre l'appareil de l'utilisateur et le système Google Play.
Les codes SERVICE_TIMEOUT et SERVICE_UNAVAILABLE ont également été mis à jour.
Pour en savoir plus, consultez Gérer les codes de réponse BillingResult
Gérer les transactions en attente
La bibliothèque Play Billing ne crée plus d'ID de commande pour les achats en attente.
Pour ces achats, l'ID de commande est renseigné une fois l'achat transféré.
à l'état PURCHASED. Assurez-vous que votre intégration attend
un ID de commande qu'une fois la transaction entièrement terminée. Vous pouvez toujours utiliser
le jeton d'achat pour vos archives.
Pour en savoir plus sur la gestion des achats en attente, consultez les le guide d'intégration de la bibliothèque Play Billing et le guide de gestion du cycle de vie des achats.
Gérer les API de facturation alternative supprimées
Suppression de BillingClient.Builder.enableAlternativeBilling,
AlternativeBillingListener,
et AlternativeChoiceDetails.
Les développeurs doivent utiliser BillingClient.Builder.enableUserChoiceBilling() avec UserChoiceBillingListener
et UserChoiceDetails
dans le rappel de l'écouteur.
Cette mise à jour renomme les API obsolètes sans aucun changement de comportement.
Modifications facultatives
PBL 7 comprend deux nouvelles API facultatives.
Prise en charge des achats de forfaits prépayés en attente
Consultez le guide Gérer les abonnements et les transactions en attente.
Abonnements à versements virtuels
Consultez le guide d'intégration des abonnements échelonnés.
Passer de PBL 6 à PBL 7
Les sections suivantes décrivent comment passer de PBL 6 à PBL 7.
Mettre à jour la Bibliothèque Google Play Billing
Mettre à jour la version de la dépendance de la bibliothèque Play Billing dans
le fichier build.gradle de votre application.
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
Ensuite, mettez à jour vos références d'API comme décrit dans les sections suivantes.
Gérer les modifications de l'API liées aux abonnements
Les API setOldSkuPurchaseToken, qui étaient obsolètes,
Suppression de setReplaceProrationMode et setReplaceSkusProrationMode.
- Remplacez
setOldSkuPurchaseTokenparsetOldPurchaseToken. - Remplacer
setReplaceProrationModeparsetSubscriptionReplacementMode - Remplacer
setReplaceSkusProrationModeparsetSubscriptionReplacementMode
Gérer les API de facturation alternative supprimées
Suppression de BillingClient.Builder.enableAlternativeBilling,
AlternativeBillingListener
et AlternativeChoiceDetails.
Les développeurs doivent utiliser BillingClient.Builder.enableUserChoiceBilling() avec UserChoiceBillingListener
et UserChoiceDetails
dans le rappel de l'écouteur.
Modifications facultatives
PBL 7 comprend deux nouvelles API facultatives.
Prise en charge des achats de forfaits prépayés en attente
Consultez le guide Gérer les abonnements et les transactions en attente.
Abonnements à versements virtuels
Consultez le guide d'intégration des abonnements échelonnés pour connaître des informations sur la façon d'intégrer ces changements dans votre application.