অ্যান্ড্রয়েড কনজিউমার SDK 3.0 মাইগ্রেশন গাইড

Kotlin 2.0 এ স্থানান্তর করুন

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

গ্রেডল এবং এজিপি সামঞ্জস্য

Kotlin 2.0-এর আপনার গ্রেডল এবং অ্যান্ড্রয়েড গ্রেডল প্লাগইন (এজিপি) সংস্করণের জন্য সর্বনিম্ন এবং সর্বোচ্চ সংস্করণের প্রয়োজনীয়তা রয়েছে। আপনার প্রকল্প Kotlin 2.0 এর জন্য এই প্রয়োজনীয়তাগুলি পূরণ করে তা নিশ্চিত করুন৷

কনজিউমার SDK 3.0+ এর জন্য AGP ন্যূনতম সংস্করণ

ভোক্তা SDK 3.0-এর জন্য AGP 7.3+ ব্যবহার করা প্রয়োজন৷

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

ভোক্তা SDK v3 এবং নীচের সম্পূর্ণ R8 মোড সমর্থন করে না। যদি আপনার অ্যাপ্লিকেশন AGP 8.0+ লক্ষ্য করে তাহলে আপনাকে অবশ্যই সম্পূর্ণ R8 মোড অক্ষম করতে হবে।

# settings.gradle
android.enableR8.fullMode=false

কোটলিন সংস্করণ সামঞ্জস্য

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

কোটলিন সামঞ্জস্যের পতাকা

পূর্ববর্তী বিভাগে উল্লিখিত হিসাবে, Kotlin আপগ্রেড করার সময় ভাষার 3টি পূর্ববর্তী সংস্করণ সমর্থন করে। ব্রেকিং পরিবর্তন সীমিত করতে সাহায্য করার জন্য কোটলিন দুটি পতাকা সরবরাহ করে :

ভাষা-সংস্করণ XY

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

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}
এপিআই-সংস্করণ XY

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

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

আরও লক্ষ্যযুক্ত পদ্ধতি

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