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