سازگاری و مهاجرت نسخه کاتلین

این صفحه اطلاعاتی در مورد سازگاری نسخه کاتلین برای Navigation SDK و همچنین راهنمایی برای مهاجرت به نسخه جدیدتر ارائه می‌دهد.

جدول زیر الزامات نسخه کاتلین و نسخه‌های AGP و Gradle پیشنهادی برای نسخه‌های اخیر Navigation SDK را شرح می‌دهد.

نسخه SDK ناوبری نسخه کاتلین (الزامی) نسخه‌های افزونه اندروید گریدل (AGP) و گریدل (توصیه می‌شود)
۶.۲+ ۲.۱
  • AGP 8.7.3
  • گریدل ۸.۱۰.۲
۶.۰ - ۶.۲ ۲.۰
  • AGP 8.3.0
  • گریدل ۸.۴
۵.۱ - ۵.۹۹.۱ ۱.۹ ما استفاده از AGP 7.3+ را توصیه می‌کنیم که برای JDK-8272564 راه‌حلی دارد.

سازگاری نسخه کاتلین

کاتلین ۲.۱ از سازگاری معکوس با کاتلین ۲.۰ پشتیبانی می‌کند. این بدان معناست که اگر در حال حاضر از کاتلین ۲.۰ به همراه Navigation SDK استفاده می‌کنید، باید بتوانید بدون نیاز به رفع تمام تغییرات اساسی، به کاتلین ۲.۱ ارتقا دهید. با این حال، این فقط در مورد ویژگی‌های پایدار زبان صدق می‌کند. اگر از ویژگی‌های آلفا، بتا یا آزمایشی در زبان کاتلین استفاده می‌کنید، ممکن است هنگام ارتقا مجبور به ایجاد تغییرات اضافی شوید.

تسهیل گذار: پرچم‌های سازگاری کاتلین

کاتلین دو پرچم (flag) برای کمک به محدود کردن تغییرات مخرب ارائه می‌دهد: https://kotlinlang.org/docs/compatibility-modes.html

زبان-نسخه XY

این پرچم تغییرات اساسی را به رفتار نسخه قبلی کاتلین برمی‌گرداند. برای مثال، اگر از کاتلین ۲.۰ استفاده می‌کنید، می‌توانید [ - language-version 2.0] را مشخص کنید و تغییرات اساسی جدید دیگر اعمال نمی‌شوند:

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

نسخه API XY

این پرچم هنگام استفاده از API از نسخه Kotlin جدیدتر از apiVersion ، خطای ساخت Gradle را نشان می‌دهد.

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

رویکردی هدفمندتر

علاوه بر استفاده از پرچم‌های سازگاری کاتلین، توصیه می‌کنیم یادداشت‌های انتشار کاتلین را بررسی کنید و رفتارهایی را که می‌خواهید از نسخه‌ای که از آن ارتقا می‌دهید حفظ شوند، انتخاب کنید. کاتلین فهرستی از تغییرات مهم و پرچم‌هایی را که می‌توان برای حفظ رفتار اصلی تنظیم کرد، در راهنماهای سازگاری خود برای هر نسخه ارائه می‌دهد:

ارتقاءهای آینده کاتلین

کاتلین هر ۶ ماه یک نسخه جدید (یعنی نسخه زبان) منتشر می‌کند و گوگل معمولاً آخرین نسخه را ۱ تا ۲ ماه پس از آن به عنوان پیش‌فرض در محصولات خود قرار می‌دهد. نسخه‌های قبلی کاتلین شامل تغییرات اساسی بوده‌اند که مشتریان Navigation SDK را ملزم به ارتقاء به نسخه جدیدتر می‌کرد. به همین دلیل، توصیه می‌کنیم هنگام اتخاذ آخرین نسخه Navigation SDK، هر ۶ ماه یک بار برای ارتقاء کاتلین برنامه‌ریزی کنید.