انتقال به Kotlin 2.0
اگر از «کیت توسعه نرم‌افزار مصرف‌کننده» برای Android نسخه ۳.۰ یا بالاتر استفاده می‌کنید، باید به Kotlin نسخه ۲.۰ ارتقا دهید. این صفحه راهنمایی‌هایی برای تسهیل انتقال به نسخه جدید Kotlin ارائه می‌دهد.
سازگاری Gradle و AGP
Kotlin 2.0 برای نسخه Gradle و «افزایه Android Gradle» (AGP) شما شرایطی برای حداقل و حداکثر نسخه‌ها دارد. مطمئن شوید پروژه‌تان این الزامات را برای Kotlin 2.0 برآورده می‌کند.
حداقل نسخه AGP برای «کیت توسعه نرم‌افزار مصرف‌کننده» نسخه ۳.۰ و بالاتر
کیت توسعه نرم‌افزار مصرف‌کننده نسخه ۳.۰ به استفاده از AGP نسخه ۷.۳ یا بالاتر نیاز دارد.
حالت کامل R8
کیت توسعه نرم‌افزار Consumer نسخه ۳ و پایین‌تر از حالت Full R8 پشتیبانی نمی‌کند. اگر برنامه شما AGP 8.0+ را هدف قرار می‌دهد، باید صریحاً حالت Full R8 را غیرفعال کنید.
# settings.gradle
android.enableR8.fullMode=false
سازگاری نسخه Kotlin
Kotlin از سازگاری با نسخه قدیمی با سه نسخه قبلی زبان پشتیبانی می‌کند. این یعنی اگر ازقبل از Kotlin 1.7+ با «کیت توسعه نرم‌افزار مصرف‌کننده» استفاده می‌کنید، باید بتوانید بدون نیاز به رفع همه تغییرات شکننده به Kotlin 2.0 ارتقا دهید. بااین‌حال، سازگاری Kotlin فقط برای ویژگی‌های زبان پایدار اعمال می‌شود. اگر از ویژگی‌های آلفا، بتا، یا آزمایشی در زبان Kotlin استفاده می‌کنید، هنگام ارتقا دادن ممکن است مجبور شوید تغییرات بیشتری ایجاد کنید.
پرچم‌های سازگاری Kotlin
همان‌طور که در بخش قبلی اشاره شد، Kotlin هنگام ارتقا دادن از حداکثر ۳ نسخه قبلی زبان پشتیبانی می‌کند. Kotlin دو پرچم برای کمک به محدود کردن تغییرات مخرب ارائه می‌دهد:
language-version X.Y
این پرچم تغییرات ناسازگار را به رفتار نسخه قبلی Kotlin برمی‌گرداند.
برای مثال، اگر از Kotlin 1.7 استفاده می‌کنید، می‌توانید [ -
language-version 1.7] را مشخص کنید و تغییرات ناسازگار جدید دیگر اعمال نخواهند شد:
android {
kotlinOptions {
languageVersion = '1.7'
}
}
نسخه API X.Y
این پرچم از استفاده از APIهای جدید قبل‌از اینکه کد پایین‌دستی وابسته برای ادغام Kotlin 2.0 آماده شود جلوگیری می‌کند.
android {
kotlinOptions {
apiVersion = '1.7'
}
}
رویکرد هدفمندتر
علاوه‌بر استفاده از پرچم‌های سازگاری Kotlin، توصیه می‌کنیم یادداشت‌های انتشار Kotlin را مرور کنید و رفتارهایی را که می‌خواهید از نسخه‌ای که ارتقا می‌دهید حفظ کنید انتخاب کنید. Kotlin فهرستی از تغییرات اساسی و پرچم‌هایی که می‌توانند برای حفظ رفتار اصلی در راهنمای سازگاری آن برای هر نسخه تنظیم شوند ارائه می‌دهد: