ย้ายข้อมูลจากเวอร์ชัน 6 หรือ 7 ไปยัง Google Play Billing Library 8

เอกสารนี้อธิบายวิธีย้ายข้อมูลจาก Google Play Billing Library (PBL) 6 หรือ 7 ไปยัง PBL 8 และวิธีผสานรวมกับความสามารถในการสมัครใช้บริการใหม่ที่ไม่บังคับ

ดูรายการการเปลี่ยนแปลงทั้งหมดในเวอร์ชัน 8.0.0 ได้ที่บันทึกประจำรุ่น

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

Help me upgrade my Play Billing Library implementation.

ภาพรวม

PBL 8 มีการปรับปรุง API ที่มีอยู่ รวมถึงการนำ API ที่เลิกใช้งานก่อนหน้านี้ออก ไลบรารีเวอร์ชันนี้ยังมี API ใหม่สำหรับผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวด้วย

ความเข้ากันได้แบบย้อนหลังสำหรับการอัปเกรด PBL

หากต้องการย้ายข้อมูลไปยัง PBL 8 คุณต้องอัปเดตหรือนำการอ้างอิง API ที่มีอยู่ออกจากแอปตามที่อธิบายไว้ในบันทึกประจำรุ่นและในคำแนะนำในการย้ายข้อมูลนี้ในภายหลัง

อัปเกรดจาก PBL 6 หรือ 7 เป็น PBL 8

หากต้องการอัปเกรดจาก PBL 6 หรือ 7 เป็น PBL 8 ให้ทำตามขั้นตอนต่อไปนี้

1. อัปเดตเวอร์ชันทรัพยากร Dependency ของ Play Billing Library ในไฟล์ build.gradle ของแอป

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

2. (ใช้ได้กับการอัปเกรดจาก PBL 6 เป็น PBL 8 เท่านั้น) จัดการการเปลี่ยนแปลง API ที่เกี่ยวข้องกับการสมัครใช้บริการในแอป

   ตารางต่อไปนี้แสดง API ที่เกี่ยวข้องกับการสมัครใช้บริการซึ่งถูกนำออกใน PBL 8 และ API สำรองที่เกี่ยวข้องซึ่งคุณต้องใช้ในแอป

   นำ API ที่เลิกใช้งานก่อนหน้านี้ออกใน PBL 8	API สำรองที่ใช้ได้
   setOldSkuPurchaseToken	setOldPurchaseToken
   setReplaceProrationMode	setSubscriptionReplacementMode
   setReplaceSkusProrationMode	setSubscriptionReplacementMode

3. อัปเดตการติดตั้งใช้งานเมธอด queryProductDetailsAsync

   มีการเปลี่ยนแปลงในซิกเนเจอร์ของเมธอด ProductDetailsResponseListener.onProductDetailsResponse ซึ่งทำให้คุณต้องทำการเปลี่ยนแปลงในแอปสำหรับการติดตั้งใช้งาน queryProductDetailsAsync ดูข้อมูลเพิ่มเติมได้ที่แสดงผลิตภัณฑ์ที่พร้อมจำหน่าย

4. จัดการ API ที่ถูกนำออก

   อัปเกรดจาก

   PBL 8 ไม่รองรับ API ที่แสดงในตารางต่อไปนี้อีกต่อไป หากการติดตั้งใช้งานของคุณใช้ API ที่ถูกนำออกเหล่านี้ โปรดดูตารางสำหรับ API สำรองที่เกี่ยวข้อง

   นำ API ที่เลิกใช้งานก่อนหน้านี้ออกใน PBL 8	API สำรองที่ใช้ได้
   API ของ queryPurchaseHistoryAsync	ดูค้นหาประวัติการซื้อ
   querySkuDetailsAsync	queryProductDetailsAsync
   enablePendingPurchases() (API ที่ไม่มีพารามิเตอร์)	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

   อัปเกรดจาก

   ตารางต่อไปนี้แสดง API ที่ถูกนำออกใน PBL 8 และ API สำรองที่เกี่ยวข้องซึ่งคุณต้องใช้ในแอป

   นำ API ที่เลิกใช้งานก่อนหน้านี้ออกใน PBL 8	API สำรองที่ใช้ได้
   API ของ queryPurchaseHistoryAsync	ดูค้นหาประวัติการซื้อ
   querySkuDetailsAsync	queryProductDetailsAsync
   enablePendingPurchases() (API ที่ไม่มีพารามิเตอร์)	enablePendingPurchases(PendingPurchaseParams params) โปรดทราบว่า enablePendingPurchases() ที่เลิกใช้งานแล้วมีฟังก์ชันการทำงานเทียบเท่ากับ enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build())
   queryPurchasesAsync(String skuType, PurchasesResponseListener listener)	queryPurchasesAsync

5. (แนะนำ) เปิดใช้การเชื่อมต่อบริการอีกครั้งโดยอัตโนมัติ

   Play Billing Library สามารถพยายามสร้างการเชื่อมต่อบริการอีกครั้งโดยอัตโนมัติหากมีการเรียก API ขณะที่บริการถูกตัดการเชื่อมต่อ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเปิดใช้การเชื่อมต่อบริการอีกครั้งโดยอัตโนมัติ

6. การเปลี่ยนแปลงที่ไม่บังคับ

   • รองรับการซื้อที่รอดำเนินการสำหรับแพ็กเกจแบบชำระเงินล่วงหน้า ดูข้อมูลเพิ่มเติมได้ที่จัดการการสมัครใช้บริการและธุรกรรมที่รอดำเนินการ

   • การสมัครใช้บริการแบบผ่อนชำระเสมือนจริง ดูข้อมูลเพิ่มเติมได้ที่การผสานรวมการสมัครใช้บริการแบบผ่อนชำระ