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

এই পৃষ্ঠায় Navigation SDK-এর জন্য Kotlin ভার্সনের কম্প্যাটিবিলিটি সম্পর্কে তথ্য এবং নতুন ভার্সনে মাইগ্রেট করার জন্য নির্দেশিকা দেওয়া হয়েছে।

নিচের সারণীতে Kotlin ভার্সনের প্রয়োজনীয়তা এবং Navigation SDK-এর সাম্প্রতিক ভার্সনের জন্য সাজেস্ট করা AGP ও Gradle ভার্সনের রূপরেখা দেওয়া হয়েছে।

Navigation SDK ভার্সন Kotlin ভার্সন (প্রয়োজনীয়) Android Gradle প্লাগ-ইন (AGP) এবং Gradle ভার্সন (সাজেস্ট করা হয়েছে)
৮.০+ 2.3.0
  • AGP 9.0.1
  • Gradle 9.1.0

গুরুত্বপূর্ণ: Navigation SDK 8.0 এবং তার পরবর্তী ভার্সনের জন্য, AGP 9.0.1 হল ন্যূনতম প্রয়োজনীয়তা, এটি কোনও সাজেশন নয়। SDK minAndroidGradlePluginVersion=9.0.1 ঘোষণা করে এবং AGP-এর আগের ভার্সন ব্যবহার করে বিল্ড করা যায় না।

৭.৭ - ৭.৯ 2.3.0
  • AGP 8.13.2
  • Gradle 8.13
৭.৩ - ৭.৬ ২.২.১০
  • AGP 8.10.0
  • Gradle 8.11.1
৬.৩ - ৭.২ ২.১
  • AGP 8.7.3
  • Gradle 8.10.2
6.0 - 6.2 ২.০
  • AGP 8.3.0
  • Gradle 8.4
৫.১ - ৫.৯৯.১ ১.৯ আমরা AGP 7.3+ ব্যবহার করার সাজেশন দিই, যাতে JDK-8272564-এর জন্য একটি ওয়ার্কঅ্যারাউন্ড আছে।

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

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

ট্রানজিশন সহজ করা: Kotlin কম্প্যাটিবিলিটি ফ্ল্যাগ

ব্রেকিং পরিবর্তন সীমিত করতে Kotlin দুটি ফ্ল্যাগ প্রদান করে: https://kotlinlang.org/docs/compatibility-modes.html

language-version X.Y

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

android {
   kotlinOptions {
       languageVersion = '2.2'
   }
}

api-version X.Y

apiVersion-এর থেকে নতুন Kotlin ভার্সনের API ব্যবহার করা হলে, এই ফ্ল্যাগ Gradle বিল্ড সংক্রান্ত সমস্যা দেখায়।

android {
   kotlinOptions {
       apiVersion = '2.2'
   }
}

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

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

ভবিষ্যতে Kotlin আপগ্রেড করা

Kotlin প্রতি ৬ মাস অন্তর নতুন ভার্সন (যেমন, ল্যাঙ্গুয়েজ রিলিজ) রিলিজ করে এবং Google সাধারণত তার ১-২ মাস পরে আমাদের প্রোডাক্টে ডিফল্ট হিসেবে লেটেস্ট ভার্সন অন্তর্ভুক্ত করে। Kotlin-এর আগের ভার্সনে ব্রেকিং পরিবর্তন অন্তর্ভুক্ত ছিল যার জন্য Navigation SDK গ্রাহকদের নতুন ভার্সনে আপগ্রেড করতে হয়েছে। এই কারণে, আমরা সাজেস্ট করি যে লেটেস্ট Navigation SDK ভার্সন গ্রহণ করার সময় প্রতি ৬ মাস অন্তর Kotlin আপগ্রেড করার পরিকল্পনা করুন।