Google Play Billing Library 6 या 7 से Google Play Billing Library 8 पर माइग्रेट करना

इस दस्तावेज़ में, Google Play Billing Library (पीबीएल) 6 या 7 से पीबीएल 8 पर माइग्रेट करने का तरीका बताया गया है. साथ ही, सदस्यता से जुड़ी नई सुविधाओं को इंटिग्रेट करने का तरीका बताया गया है.

वर्शन 8.0.0 में हुए बदलावों की पूरी सूची देखने के लिए, रिलीज़ नोट पढ़ें.

Android स्किल

GitHub पर देखें

Play Billing Library को अपग्रेड करना

Play Billing Library के नए वर्शन पर अपने-आप अपग्रेड होने के लिए, Android स्किल का इस्तेमाल करें.

Android के सीएलआई से स्किल इंस्टॉल करने के लिए, यह कमांड चलाएं:

android skills add play-billing-library-version-upgrade

स्किल चालू करने के लिए, यह प्रॉम्प्ट आज़माएं:

Help me upgrade my Play Billing Library implementation.

खास जानकारी

PBL 8 में, मौजूदा एपीआई में सुधार किए गए हैं. साथ ही, पहले से बंद किए गए एपीआई हटा दिए गए हैं. लाइब्रेरी के इस वर्शन में, वन-टाइम प्रॉडक्ट के लिए नए एपीआई भी शामिल हैं.

पीबीएल अपग्रेड के लिए, पुराने सिस्टम के साथ काम करने की सुविधा

PBL 8 पर माइग्रेट करने के लिए, आपको अपने ऐप्लिकेशन से कुछ मौजूदा एपीआई रेफ़रंस हटाने होंगे या उन्हें अपडेट करना होगा. इसके बारे में प्रॉडक्ट की जानकारी और माइग्रेट करने से जुड़ी इस गाइड में आगे बताया गया है.

PBL 6 या 7 से PBL 8 पर अपग्रेड करना

पीबीएल 6 या 7 से पीबीएल 8 पर अपग्रेड करने के लिए, यह तरीका अपनाएं:

1. अपने ऐप्लिकेशन की build.gradle फ़ाइल में, Play Billing Library की डिपेंडेंसी का वर्शन अपडेट करें.

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

2. (यह सिर्फ़ पीबीएल 6 से पीबीएल 8 पर अपग्रेड करने के लिए लागू होता है). अपने ऐप्लिकेशन में सदस्यता से जुड़े एपीआई में बदलावों को मैनेज करें.

   यहां दी गई टेबल में, सदस्यता से जुड़े उन एपीआई की सूची दी गई है जिन्हें PBL 8 में हटा दिया गया है. साथ ही, इसमें उन एपीआई की सूची भी दी गई है जिन्हें आपको अपने ऐप्लिकेशन में इस्तेमाल करना चाहिए.

   PBL 8 में, पहले से बंद किए गए एपीआई को हटा दिया गया है	इस्तेमाल करने के लिए वैकल्पिक एपीआई
   setOldSkuPurchaseToken	setOldPurchaseToken
   setReplaceProrationMode	setSubscriptionReplacementMode
   setReplaceSkusProrationMode	setSubscriptionReplacementMode

3. queryProductDetailsAsync तरीके को लागू करने की प्रोसेस को अपडेट करें.

   ProductDetailsResponseListener.onProductDetailsResponse तरीके के सिग्नेचर में बदलाव किया गया है. इसके लिए, आपको queryProductDetailsAsync को लागू करने के लिए, अपने ऐप्लिकेशन में बदलाव करने होंगे. ज़्यादा जानकारी के लिए, खरीदने के लिए उपलब्ध प्रॉडक्ट दिखाना लेख पढ़ें.

4. हटाए गए एपीआई को मैनेज करना.

   इनसे अपग्रेड करें

   PBL 8, यहां दी गई टेबल में मौजूद एपीआई के साथ काम नहीं करता. अगर आपके इंटिग्रेशन में, हटाए गए किसी भी एपीआई का इस्तेमाल किया जाता है, तो उनके विकल्प के तौर पर उपलब्ध एपीआई के लिए टेबल देखें.

   PBL 8 में, पहले से बंद किए गए एपीआई को हटा दिया गया है	इस्तेमाल करने के लिए वैकल्पिक एपीआई
   queryPurchaseHistoryAsync एपीआई	खरीदारी के इतिहास के बारे में क्वेरी करना देखें
   querySkuDetailsAsync	queryProductDetailsAsync
   enablePendingPurchases() (बिना पैरामीटर वाला एपीआई)	enablePendingPurchases(PendingPurchaseParams params) ध्यान दें कि बंद किया गया enablePendingPurchases() फ़ंक्शन, enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()) के बराबर है.
   queryPurchasesAsync(String skuType, PurchasesResponseListener listener)	queryPurchasesAsync
   BillingClient.Builder.enableAlternativeBilling	BillingClient.Builder.enableUserChoiceBilling
   AlternativeBillingListener	UserChoiceBillingListener
   AlternativeChoiceDetails	UserChoiceDetails

   इनसे अपग्रेड करें

   यहां दी गई टेबल में, PBL 8 से हटाए गए एपीआई और उनके विकल्प के तौर पर इस्तेमाल किए जा सकने वाले एपीआई की सूची दी गई है. आपको अपने ऐप्लिकेशन में इन एपीआई का इस्तेमाल करना चाहिए.

   PBL 8 में, पहले से बंद किए गए एपीआई को हटा दिया गया है	इस्तेमाल करने के लिए वैकल्पिक एपीआई
   queryPurchaseHistoryAsync एपीआई	खरीदारी के इतिहास के बारे में क्वेरी करना देखें
   querySkuDetailsAsync	queryProductDetailsAsync
   enablePendingPurchases() (बिना पैरामीटर वाला एपीआई)	enablePendingPurchases(PendingPurchaseParams params) ध्यान दें कि बंद किया गया enablePendingPurchases() फ़ंक्शन, enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()) के बराबर है.
   queryPurchasesAsync(String skuType, PurchasesResponseListener listener)	queryPurchasesAsync

5. (सुझाया गया) सेवा के अपने-आप फिर से कनेक्ट होने की सुविधा चालू करें.

   अगर सेवा डिसकनेक्ट होने के दौरान कोई एपीआई कॉल किया जाता है, तो Play Billing Library, सेवा कनेक्शन को अपने-आप फिर से चालू करने की कोशिश कर सकती है. ज़्यादा जानकारी के लिए, सेवा के अपने-आप फिर से कनेक्ट होने की सुविधा चालू करना लेख पढ़ें.

6. वैकल्पिक बदलाव.

   • प्रीपेड प्लान के लिए, अधूरी खरीदारी की सुविधा उपलब्ध कराएं. ज़्यादा जानकारी के लिए, सदस्यताएं और ऐसे लेन-देन मैनेज करना जिन्हें मंज़ूरी नहीं मिली है लेख पढ़ें.

   • वर्चुअल तौर पर ली जाने वाली किस्त वाली सदस्यताएं. ज़्यादा जानकारी के लिए, किस्तों में सदस्यता लेने की सुविधा को इंटिग्रेट करना लेख पढ़ें.