Passer de la bibliothèque Google Play Billing 6 ou 7 à la version 8

Ce document explique comment migrer de la bibliothèque Google Play Billing (PBL) 6 ou 7 vers la PBL 8, et comment intégrer les nouvelles fonctionnalités d'abonnement facultatives.

Pour obtenir la liste complète des modifications apportées à la version 8.0.0, consultez les [notes de version][1].

Présentation

PBL 8 contient des améliorations apportées aux API existantes, ainsi que la suppression des API précédemment obsolètes. Cette version de la bibliothèque inclut également de nouvelles API pour les produits ponctuels.

Rétrocompatibilité pour la mise à niveau de PBL

Pour migrer vers PBL 8, vous devez mettre à jour ou supprimer certaines de vos références d'API existantes dans votre application, comme décrit dans les [notes de version][8] et plus loin dans ce guide de migration.

Mettre à niveau PBL 6 ou 7 vers PBL 8

Pour passer de PBL 6 ou 7 à PBL 8, procédez comme suit :

  1. Mettez à jour la version de la dépendance de la bibliothèque Play Billing dans le fichier build.gradle de votre application.

    dependencies {
  def billingVersion = 8.0.0
  implementation "com.android.billingclient:billing:$billingVersion"
}

  2. (Applicable uniquement pour la mise à niveau de PBL 6 vers PBL 8) Gérez les modifications d'API liées aux abonnements dans votre application.

    Le tableau suivant liste les API liées aux abonnements qui ont été supprimées dans PBL 8, ainsi que les API alternatives correspondantes que vous devez utiliser dans votre application.

    Suppression de l'API précédemment obsolète dans PBL 8 Autre API à utiliser
    setOldSkuPurchaseToken setOldPurchaseToken
    setReplaceProrationMode setSubscriptionReplacementMode
    setReplaceSkusProrationMode setSubscriptionReplacementMode

  3. Mettez à jour l'implémentation de la méthode [queryProductDetailsAsync][9].

    La signature de la méthode [ProductDetailsResponseListener.onProductDetailsResponse][2] a changé, ce qui nécessite des modifications dans votre application pour l'implémentation de [queryProductDetailsAsync][9]. Pour en savoir plus, consultez [Afficher les produits disponibles à l'achat][3].

  4. Gérez les API supprimées.

    Mettre à niveau

    PBL 8 n'est plus compatible avec les API listées dans le tableau suivant. Si votre implémentation utilise l'une de ces API supprimées, consultez le tableau pour connaître les API alternatives correspondantes.

    Suppression de l'API précédemment obsolète dans PBL 8 Autre API à utiliser
    API queryPurchaseHistoryAsync Consultez Interroger l'historique des achats.
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (API sans paramètres) enablePendingPurchases(PendingPurchaseParams params)
    Notez que la méthode enablePendingPurchases() obsolète est fonctionnellement équivalente à enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()).
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync
    BillingClient.Builder.enableAlternativeBilling BillingClient.Builder.enableUserChoiceBilling
    AlternativeBillingListener UserChoiceBillingListener
    AlternativeChoiceDetails UserChoiceDetails

    Mettre à niveau

    Le tableau suivant répertorie les API supprimées dans PBL 8 et les API alternatives correspondantes que vous devez utiliser dans votre application.

    Suppression de l'API précédemment obsolète dans PBL 8 Autre API à utiliser
    API queryPurchaseHistoryAsync Consultez Interroger l'historique des achats.
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (API sans paramètres) enablePendingPurchases(PendingPurchaseParams params)
    Notez que la méthode enablePendingPurchases() obsolète est fonctionnellement équivalente à enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()).
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync

  5. (Recommandé) Activez la reconnexion automatique du service.

    La bibliothèque Play Billing peut tenter de rétablir automatiquement la connexion au service si un appel d'API est effectué alors que le service est déconnecté. Pour en savoir plus, consultez [Activer la reconnexion automatique du service][6].

  6. Modifications facultatives.

    • Prise en charge des achats en attente pour les forfaits prépayés. Pour en savoir plus, consultez [Gérer les abonnements et les transactions en attente][4].

    • Abonnements avec versements virtuels Pour en savoir plus, consultez [Intégration des abonnements avec paiements échelonnés][5].

[1]: /google/play/billing/release-notes [2]: /reference/com/android/billingclient/api/ProductDetailsResponseListener#onProductDetailsResponse(com.android.billingclient.api.BillingResult,java.util.List%3Ccom.android.billingclient.api.ProductDetails%3E) [3]: /google/play/billing/integrate#show-products [4]: /google/play/billing/subscriptions#pending [5]: /google/play/billing/subscriptions#installments [6]: /google/play/billing/integrate#automatic-service-reconnection [8]: /google/play/billing/release-notes [9]: /reference/com/android/billingclient/api/BillingClient#queryProductDetailsAsync