Kotlin 2.0-এ স্থানান্তরিত করুন
আপনি যদি অ্যান্ড্রয়েড ৩.০+ এর জন্য কনজিউমার এসডিকে ব্যবহার করে থাকেন, তবে আপনাকে অবশ্যই কোটলিন ২.০-তে আপগ্রেড করতে হবে। এই পৃষ্ঠাটি নতুন কোটলিন সংস্করণে রূপান্তর সহজ করার জন্য নির্দেশনা প্রদান করে।
Gradle এবং AGP সামঞ্জস্যতা
Kotlin 2.0-এর জন্য আপনার Gradle এবং Android Gradle Plugin (AGP)-এর সর্বনিম্ন ও সর্বোচ্চ সংস্করণের কিছু আবশ্যকতা রয়েছে। নিশ্চিত করুন যে আপনার প্রজেক্টটি Kotlin 2.0-এর জন্য এই আবশ্যকতাগুলো পূরণ করে।
কনজিউমার এসডিকে ৩.০+ এর জন্য এজিপি সর্বনিম্ন সংস্করণ
কনজিউমার এসডিকে ৩.০ ব্যবহারের জন্য এজিপি ৭.৩+ প্রয়োজন।
সম্পূর্ণ R8 মোড
কনজিউমার এসডিকে v3 এবং এর নিচের সংস্করণগুলো ফুল আর৮ মোড সমর্থন করে না। আপনার অ্যাপ্লিকেশনটি যদি এজিপি ৮.০+ টার্গেট করে, তবে আপনাকে অবশ্যই ফুল আর৮ মোড স্পষ্টভাবে নিষ্ক্রিয় করতে হবে।
# settings.gradle
android.enableR8.fullMode=false
কোটলিন সংস্করণের সামঞ্জস্যতা
কোটলিন পূর্ববর্তী তিনটি ল্যাঙ্গুয়েজ ভার্সনের সাথে ব্যাকওয়ার্ড কম্প্যাটিবিলিটি সমর্থন করে। এর মানে হলো, আপনি যদি কনজিউমার এসডিকে-এর সাথে ইতিমধ্যেই কোটলিন ১.৭+ ব্যবহার করে থাকেন, তাহলে সমস্ত ব্রেকিং চেঞ্জেস সমাধান না করেই আপনি কোটলিন ২.০-তে আপগ্রেড করতে পারবেন। তবে, কোটলিনের এই কম্প্যাটিবিলিটি শুধুমাত্র স্টেবল ল্যাঙ্গুয়েজ ফিচারগুলোর ক্ষেত্রেই প্রযোজ্য । আপনি যদি কোটলিন ল্যাঙ্গুয়েজের আলফা, বিটা বা এক্সপেরিমেন্টাল ফিচার ব্যবহার করেন, তাহলে আপগ্রেড করার সময় আপনাকে অতিরিক্ত কিছু পরিবর্তন করতে হতে পারে।
কোটলিন সামঞ্জস্যতা ফ্ল্যাগ
পূর্ববর্তী বিভাগে যেমন উল্লেখ করা হয়েছে, আপগ্রেড করার সময় কোটলিন ভাষাটির সর্বোচ্চ ৩টি পূর্ববর্তী সংস্করণ সমর্থন করে। বড় ধরনের পরিবর্তন (breaking changes) সীমিত করতে সাহায্য করার জন্য কোটলিন দুটি ফ্ল্যাগ সরবরাহ করে :
ভাষা-সংস্করণ XY
এই ফ্ল্যাগটি পূর্ববর্তী কোটলিন সংস্করণের আচরণে আসা বড় ধরনের পরিবর্তনগুলো পূর্বাবস্থায় ফিরিয়ে আনে। উদাহরণস্বরূপ, আপনি যদি কোটলিন ১.৭ ব্যবহার করেন, তাহলে আপনি [ - language-version 1.7] উল্লেখ করতে পারেন এবং নতুন বড় ধরনের পরিবর্তনগুলো আর কার্যকর হবে না:
android {
kotlinOptions {
languageVersion = '1.7'
}
}
এপিআই-সংস্করণ XY
এই ফ্ল্যাগটি নির্ভরশীল ডাউনস্ট্রিম কোড কোটলিন ২.০ অন্তর্ভুক্ত করার জন্য প্রস্তুত হওয়ার আগে নতুন এপিআই ব্যবহার করা থেকে বিরত রাখে।
android {
kotlinOptions {
apiVersion = '1.7'
}
}
আরও লক্ষ্যভিত্তিক পদ্ধতি
Kotlin কম্প্যাটিবিলিটি ফ্ল্যাগ ব্যবহার করার পাশাপাশি, আমরা Kotlin রিলিজ নোট পর্যালোচনা করার এবং যে সংস্করণ থেকে আপনি আপগ্রেড করছেন, তার থেকে যে আচরণগুলো আপনি ধরে রাখতে চান তা বেছে নেওয়ার পরামর্শ দিই। Kotlin তার প্রতিটি সংস্করণের কম্প্যাটিবিলিটি গাইডে ব্রেকিং চেঞ্জগুলোর একটি তালিকা এবং মূল আচরণ ধরে রাখার জন্য যে ফ্ল্যাগগুলো সেট করা যেতে পারে, তা প্রদান করে থাকে: