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

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

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

نسخه SDK ناوبری نسخه کاتلین (الزامی) پلاگین Android Gradle (AGP) و نسخه های Gradle (توصیه می شود)
6.2+ 2.1
  • AGP 8.7.3
  • Gradle 8.10.2
6.0 - 6.2 2.0
  • AGP 8.3.0
  • درجه 8.4
5.1 - 5.99.1 1.9 توصیه می کنیم از AGP 7.3+ استفاده کنید که راه حلی برای JDK-8272564 دارد.

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

Kotlin 2.1 از سازگاری به عقب با Kotlin 2.0 پشتیبانی می کند. این بدان معناست که اگر قبلاً از Kotlin 2.0 با Navigation SDK استفاده می‌کنید، باید بتوانید بدون نیاز به رفع تمام تغییرات شکسته به Kotlin 2.1 ارتقا دهید. با این حال، این فقط برای ویژگی‌های زبان پایدار اعمال می‌شود. اگر از ویژگی‌های آلفا، بتا یا آزمایشی در زبان Kotlin استفاده می‌کنید، ممکن است مجبور شوید تغییرات بیشتری در هنگام ارتقا ایجاد کنید.

تسهیل انتقال: پرچم های سازگاری Kotlin

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

زبان-نسخه XY

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

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

api-نسخه XY

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

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

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

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

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

Kotlin هر 6 ماه یک نسخه جدید (یعنی انتشار زبان) منتشر می کند و Google معمولاً 1 تا 2 ماه پس از آن آخرین نسخه را به عنوان پیش فرض در محصولات ما قرار می دهد. نسخه‌های قبلی Kotlin شامل تغییراتی بودند که مشتریان SDK ناوبری را به نسخه جدیدتر ارتقا می‌دادند. به همین دلیل، توصیه می کنیم هنگام استفاده از آخرین نسخه Navigation SDK، هر 6 ماه یک بار برای ارتقای Kotlin برنامه ریزی کنید.

،

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

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

نسخه SDK ناوبری نسخه کاتلین (الزامی) پلاگین Android Gradle (AGP) و نسخه های Gradle (توصیه می شود)
6.2+ 2.1
  • AGP 8.7.3
  • Gradle 8.10.2
6.0 - 6.2 2.0
  • AGP 8.3.0
  • درجه 8.4
5.1 - 5.99.1 1.9 توصیه می کنیم از AGP 7.3+ استفاده کنید که راه حلی برای JDK-8272564 دارد.

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

Kotlin 2.1 از سازگاری به عقب با Kotlin 2.0 پشتیبانی می کند. این بدان معناست که اگر قبلاً از Kotlin 2.0 با Navigation SDK استفاده می‌کنید، باید بتوانید بدون نیاز به رفع تمام تغییرات شکسته به Kotlin 2.1 ارتقا دهید. با این حال، این فقط برای ویژگی‌های زبان پایدار اعمال می‌شود. اگر از ویژگی‌های آلفا، بتا یا آزمایشی در زبان Kotlin استفاده می‌کنید، ممکن است مجبور شوید تغییرات بیشتری در هنگام ارتقا ایجاد کنید.

تسهیل انتقال: پرچم های سازگاری Kotlin

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

زبان-نسخه XY

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

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

api-نسخه XY

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

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

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

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

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

Kotlin هر 6 ماه یک نسخه جدید (یعنی انتشار زبان) منتشر می کند و Google معمولاً 1 تا 2 ماه پس از آن آخرین نسخه را به عنوان پیش فرض در محصولات ما قرار می دهد. نسخه‌های قبلی Kotlin شامل تغییراتی بودند که مشتریان SDK ناوبری را به نسخه جدیدتر ارتقا می‌دادند. به همین دلیل، توصیه می کنیم هنگام استفاده از آخرین نسخه Navigation SDK، هر 6 ماه یک بار برای ارتقای Kotlin برنامه ریزی کنید.