انتقال به میانای DriverStatusListener
در «نسخه ۵ درایور»، منسوخ شدن رابط StatusListener را به نفع DriverStatusListener اعلام کردیم. امسال، به‌طور رسمی رابط
StatusListener را حذف می‌کنیم. برای راهنمای انتقال به میانای جدید، به StatusListener
منسوخ شدن
مراجعه کنید.
انتقال به Kotlin 2.0
اگر از «کیت توسعه نرم‌افزار راننده» برای Android 6.0+ استفاده می‌کنید، باید به Kotlin 2.0 ارتقا دهید. این صفحه راهنمایی‌هایی برای تسهیل انتقال به نسخه جدید Kotlin ارائه می‌دهد.
سازگاری Gradle و AGP
Kotlin 2.0 برای نسخه Gradle و «افزایه Android Gradle» (AGP) شما شرایطی برای حداقل و حداکثر نسخه‌ها دارد. مطمئن شوید پروژه‌تان این الزامات را برای Kotlin 2.0 برآورده می‌کند.
حداقل نسخه AGP برای «کیت توسعه نرم‌افزار راننده» نسخه ۶.۰ و بالاتر
توصیه می‌کنیم از AGP 7.3+ با «کیت توسعه نرم‌افزار درایور» نسخه ۶.۰ استفاده کنید.
حالت کامل R8
کیت توسعه نرم‌افزار Driver نسخه ۶ و پایین‌تر از حالت Full R8 پشتیبانی نمی‌کند. اگر برنامه شما AGP 8.0+ را هدف‌یابی می‌کند، باید حالت «کامل R8» را به‌طور صریح غیرفعال کنید.
# settings.gradle
android.enableR8.fullMode=false
سازگاری نسخه Kotlin
Kotlin از سازگاری با سه نسخه قبلی زبان پشتیبانی می‌کند. این یعنی اگر ازقبل از Kotlin 1.7+ با «کیت توسعه نرم‌افزار Driver» استفاده می‌کنید، می‌توانید بدون نیاز به رفع همه تغییرات اساسی به 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 فهرستی از تغییرات اساسی و پرچم‌هایی که می‌توانند برای حفظ رفتار اصلی در راهنمای سازگاری آن برای هر نسخه تنظیم شوند ارائه می‌دهد: