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

কোটলিন ২.০ এ স্থানান্তর করুন

আপনি যদি অ্যান্ড্রয়েড ৩.০+ এর জন্য কনজিউমার এসডিকে ব্যবহার করেন তবে আপনাকে অবশ্যই কোটলিন ২.০ এ আপগ্রেড করতে হবে। এই পৃষ্ঠাটি নতুন কোটলিন সংস্করণে রূপান্তর সহজ করার জন্য নির্দেশিকা প্রদান করে।

গ্র্যাডল এবং AGP এর সামঞ্জস্য

আপনার গ্র্যাডল এবং অ্যান্ড্রয়েড গ্র্যাডল প্লাগইন (AGP) সংস্করণের জন্য 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

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

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

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

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

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

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

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

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

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

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

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