Google Play Billing Library 5 বা 6 থেকে Google Play Billing Library 7-এ কীভাবে মাইগ্রেট করবেন এবং নতুন ঐচ্ছিক সাবস্ক্রিপশন ক্ষমতার সাথে কীভাবে ইন্টিগ্রেট করবেন তা এই ডকুমেন্টে বর্ণনা করা হয়েছে।
7.0.0 ভার্সনে হওয়া পরিবর্তনের সম্পূর্ণ তালিকা দেখতে, রিলিজ নোট দেখুন।
এক নজরে
Google Play Billing Library 7 আগে থেকে থাকা সাবস্ক্রিপশন ফিচারের জন্য পেমেন্ট ম্যানেজমেন্ট উন্নত করে। এই ঐচ্ছিক উন্নতিগুলি ইনস্টলমেন্ট প্ল্যানের মাধ্যমে পেমেন্ট করার পাশাপাশি প্রিপেড সাবস্ক্রিপশনের জন্য বাকি থাকা কেনাকাটার ক্ষেত্রেও সহায়তা যোগ করে।
ব্যাকওয়ার্ড কম্প্যাটিবল Play Billing Library আপগ্রেড
Google Play Billing Library 7-এর সব নতুন API ঐচ্ছিক এবং আপডেট করার জন্য ডেভেলপারদের কোনও API পরিবর্তন করতে হবে না।
মাইগ্রেট করতে, আপনাকে API রেফারেন্স আপডেট করতে হবে এবং আপনার অ্যাপ থেকে নির্দিষ্ট কিছু API সরাতে হবে, যেমনটি রিলিজ নোট এবং পরে এই মাইগ্রেশন গাইডে বর্ণনা করা হয়েছে।
PBL 5 থেকে PBL 7-এ আপগ্রেড করুন
PBL 5 থেকে PBL 7-এ কীভাবে আপগ্রেড করবেন তা নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে।
Google Play Billing Library আপডেট করুন
আপনার অ্যাপের build.gradle ফাইলে Play Billing Library ডিপেন্ডেন্সি ভার্সন
আপডেট করুন।
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
এরপর, নিম্নলিখিত বিভাগে যেভাবে বর্ণনা করা হয়েছে সেইভাবে আপনার API রেফারেন্স আপডেট করুন।
ব্যবহারকারীর সাবস্ক্রিপশন কেনাকাটা পরিবর্তন করা
Play Billing Library 5 এবং তার আগের ভার্সনে ProrationMode
ব্যবহার করা হত যাতে ব্যবহারকারীর সাবস্ক্রিপশন কেনাকাটায় পরিবর্তন করা যায়, যেমন আপগ্রেড
বা ডাউনগ্রেড করা। এই API সরিয়ে দিয়ে তার জায়গায়
ReplacementMode ব্যবহার করা হয়েছে।
সাবস্ক্রিপশনের দামের পরিবর্তন ম্যানেজ করা
আগে থেকে বন্ধ হয়ে যাওয়া launchPriceConfirmationFlow API সরিয়ে দেওয়া হয়েছে।
বিকল্পের জন্য, দাম পরিবর্তন সংক্রান্ত নির্দেশিকা দেখুন।
সাবস্ক্রিপশন সম্পর্কিত API পরিবর্তন ম্যানেজ করা
আগে থেকে বন্ধ হয়ে যাওয়া API setOldSkuPurchaseToken,
setReplaceProrationMode, setReplaceSkusProrationMode সরিয়ে দেওয়া হয়েছে।
setOldSkuPurchaseTokenআপডেট করেsetOldPurchaseTokenকরুন।setReplaceProrationModeআপডেট করেsetSubscriptionReplacementModeকরুন।setReplaceSkusProrationModeআপডেট করেsetSubscriptionReplacementModeকরুন।
Play Billing Library সংক্রান্ত সমস্যার সমাধান করা
নতুন NETWORK_ERROR কোড ব্যবহারকারীর ডিভাইস ও Google Play সিস্টেমের মধ্যে
নেটওয়ার্ক কানেকশনে সমস্যা নির্দেশ করে।
SERVICE_TIMEOUT এবং SERVICE_UNAVAILABLE কোডও আপডেট করা হয়েছে।
আরও তথ্যের জন্য, BillingResult রেসপন্স কোড ম্যানেজ করা দেখুন।
পেন্ডিং ট্রানজ্যাকশন ম্যানেজ করা
Play Billing Library আর বাকি থাকা কেনাকাটার জন্য অর্ডার আইডি তৈরি করে না।
এইসব কেনাকাটার ক্ষেত্রে, কেনাকাটা PURCHASED স্ট্যাটাসে
সরানোর পরে অর্ডার আইডি দেখানো হয়। নিশ্চিত করুন যে আপনার ইন্টিগ্রেশন শুধুমাত্র একটি ট্রানজ্যাকশন সম্পূর্ণ হওয়ার পরেই
একটি অর্ডার আইডি আশা করে। আপনি এখনও আপনার রেকর্ডের জন্য
পারচেজ টোকেন ব্যবহার করতে পারবেন।
বাকি থাকা কেনাকাটা ম্যানেজ করার ব্যাপারে আরও তথ্যের জন্য, Play Billing Library ইন্টিগ্রেশন গাইড এবং কেনাকাটার লাইফসাইকেল ম্যানেজমেন্ট গাইড দেখুন।
সরিয়ে দেওয়া বিকল্প বিলিং API ম্যানেজ করা
সরানো হয়েছে
BillingClient.Builder.enableAlternativeBilling,
AlternativeBillingListener এবং
AlternativeChoiceDetails। পরিবর্তে, লিসেনার কলব্যাকে
UserChoiceBillingListener এবং
UserChoiceDetails-এর সাথে BillingClient.Builder.enableUserChoiceBilling()
ব্যবহার করুন।
এই আপডেটটি হল বন্ধ হয়ে যাওয়া API-এর নাম পরিবর্তন করা, যার ফলে আচরণে কোনও পরিবর্তন হয় না।
ঐচ্ছিক পরিবর্তন
PBL 7-এ দুটি নতুন ঐচ্ছিক API অন্তর্ভুক্ত আছে।
প্রিপেড প্ল্যানের জন্য বাকি থাকা কেনাকাটার সুবিধা
সাবস্ক্রিপশন ও পেন্ডিং ট্রানজ্যাকশন ম্যানেজ করা সংক্রান্ত নির্দেশিকা দেখুন।
ভার্চুয়াল ইনস্টলমেন্ট সাবস্ক্রিপশন
ইনস্টলমেন্ট সাবস্ক্রিপশন ইন্টিগ্রেশন নির্দেশিকা দেখুন।
PBL 6 থেকে PBL 7-এ আপগ্রেড করুন
PBL 6 থেকে PBL 7-এ কীভাবে আপগ্রেড করবেন তা নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে।
Google Play Billing Library আপডেট করুন
আপনার অ্যাপের build.gradle ফাইলে Play Billing Library ডিপেন্ডেন্সি ভার্সন
আপডেট করুন।
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
এরপর, নিম্নলিখিত বিভাগে যেভাবে বর্ণনা করা হয়েছে সেইভাবে আপনার API রেফারেন্স আপডেট করুন।
সাবস্ক্রিপশন সম্পর্কিত API পরিবর্তন ম্যানেজ করা
আগে থেকে বন্ধ হয়ে যাওয়া API setOldSkuPurchaseToken,
setReplaceProrationMode, setReplaceSkusProrationMode সরিয়ে দেওয়া হয়েছে।
setOldSkuPurchaseTokenআপডেট করেsetOldPurchaseTokenকরুন।setReplaceProrationModeআপডেট করেsetSubscriptionReplacementModeকরুন।setReplaceSkusProrationModeআপডেট করেsetSubscriptionReplacementModeকরুন।
সরিয়ে দেওয়া বিকল্প বিলিং API ম্যানেজ করা
সরানো হয়েছে
BillingClient.Builder.enableAlternativeBilling,
AlternativeBillingListener এবং
AlternativeChoiceDetails। পরিবর্তে, লিসেনার কলব্যাকে
UserChoiceBillingListener এবং
UserChoiceDetails-এর সাথে BillingClient.Builder.enableUserChoiceBilling()
ব্যবহার করুন।
ঐচ্ছিক পরিবর্তন
PBL 7-এ দুটি নতুন ঐচ্ছিক API অন্তর্ভুক্ত আছে।
প্রিপেড প্ল্যানের জন্য বাকি থাকা কেনাকাটার সুবিধা
সাবস্ক্রিপশন ও পেন্ডিং ট্রানজ্যাকশন ম্যানেজ করা সংক্রান্ত নির্দেশিকা দেখুন।
ভার্চুয়াল ইনস্টলমেন্ট সাবস্ক্রিপশন
আপনার অ্যাপে এইসব পরিবর্তন কীভাবে ইন্টিগ্রেট করবেন সেই সম্পর্কে তথ্য পেতে, ইনস্টলমেন্ট সাবস্ক্রিপশন ইন্টিগ্রেশন নির্দেশিকা দেখুন।