Android Consumer SDK 3.0 মাইগ্রেশন গাইড

Kotlin 2.0-এ মাইগ্রেট করুন

আপনি Android 3.0+ ভার্সনের জন্য Consumer SDK ব্যবহার করলে, আপনাকে Kotlin 2.0-এ আপগ্রেড করতে হবে। নতুন Kotlin ভার্সনে ট্রানজিশন সহজ করার জন্য এই পৃষ্ঠায় নির্দেশিকা দেওয়া হয়েছে।

Gradle ও AGP-এর সাথে মানানসই

Kotlin 2.0-এর জন্য আপনার Gradle এবং Android Gradle Plugin (AGP) ভার্সনের ন্যূনতম এবং সর্বাধিক ভার্সনের প্রয়োজনীয়তা রয়েছে। ভালভাবে দেখে নিন যে আপনার প্রজেক্ট Kotlin 2.0-এর জন্য এইসব প্রয়োজনীয়তা পূরণ করছে কিনা।

Consumer SDK 3.0+ ভার্সনের জন্য AGP-র ন্যূনতম ভার্সন

Consumer SDK 3.0-এর জন্য AGP 7.3+ ব্যবহার করতে হবে।

সম্পূর্ণ R8 মোড

Consumer SDK v3 এবং এর আগের ভার্সনে ফুল R8 মোড কাজ করে না। আপনার অ্যাপ্লিকেশন AGP 8.0+ ভার্সনকে টার্গেট করলে, আপনাকে অবশ্যই সম্পূর্ণ R8 মোড বন্ধ করতে হবে।

# settings.gradle
android.enableR8.fullMode=false

Kotlin ভার্সনের কম্প্যাটিবিলিটি

Kotlin আগের তিনটি ভাষার ভার্সনের সাথে ব্যাকওয়ার্ড কম্প্যাটিবিলিটি সাপোর্ট করে। এর অর্থ হল, আপনি যদি আগে থেকেই Consumer SDK-এর সাথে Kotlin 1.7+ ব্যবহার করে থাকেন, তাহলে আপনাকে ব্রেকিং পরিবর্তনগুলির সবগুলি সমাধান না করেই Kotlin 2.0-এ আপগ্রেড করতে পারবেন। তবে, Kotlin-এর সাথে মানানসই হওয়ার বিষয়টি শুধুমাত্র স্টেবল ল্যাঙ্গুয়েজ ফিচারের ক্ষেত্রে প্রযোজ্য। আপনি যদি Kotlin ভাষায় আলফা, বিটা বা পরীক্ষামূলক ফিচার ব্যবহার করেন, তাহলে আপগ্রেড করার সময় আপনাকে অতিরিক্ত পরিবর্তন করতে হতে পারে।

Kotlin কম্প্যাটিবিলিটি ফ্ল্যাগ

আগের বিভাগে যেমন উল্লেখ করা হয়েছে, আপগ্রেড করার সময় Kotlin এই ভাষার সর্বাধিক ৩টি পূর্ববর্তী ভার্সন সাপোর্ট করে। Kotlin ব্রেকিং পরিবর্তন সীমিত করতে সাহায্য করার জন্য দুটি ফ্ল্যাগ প্রদান করে:

ভাষা-ভার্সন X.Y

এই ফ্ল্যাগটি আগের Kotlin ভার্সনের আচরণে করা ব্রেকিং পরিবর্তনগুলিকে ফিরিয়ে আনে। যেমন, আপনি Kotlin 1.7 ব্যবহার করলে, [ - language-version 1.7] নির্দিষ্ট করতে পারবেন এবং নতুন ব্রেকিং পরিবর্তন আর কার্যকর হবে না:

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}
api-version X.Y

এই ফ্ল্যাগ, Kotlin 2.0 অন্তর্ভুক্ত করার জন্য নির্ভরশীল ডাউনস্ট্রিম কোড রেডি হওয়ার আগে নতুন API ব্যবহার করা থেকে আটকায়।

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

আরও বেশি টার্গেট করা পদ্ধতি

Kotlin কম্প্যাটিবিলিটি ফ্ল্যাগ ব্যবহার করা ছাড়াও, আমরা Kotlin রিলিজ নোট পর্যালোচনা করার এবং আপনি যে ভার্সন থেকে আপগ্রেড করছেন সেখান থেকে যে আচরণগুলি রাখতে চান সেগুলি বেছে নেওয়ার সাজেশন দিই। Kotlin প্রতিটি ভার্সনের জন্য তার কম্প্যাটিবিলিটি গাইডে ব্রেকিং পরিবর্তনের তালিকা এবং আসল আচরণ বজায় রাখার জন্য সেট করা যেতে পারে এমন ফ্ল্যাগ প্রদান করে: