نقل البيانات إلى واجهة DriverStatusListener
في الإصدار 5 من Driver، أعلنّا عن إيقاف واجهة StatusListener نهائيًا لصالح واجهة DriverStatusListener. سنحذف هذا العام واجهة StatusListener نهائيًا. يُرجى الرجوع إلى مقالة إيقاف واجهة StatusListener
نهائيًا
للاطّلاع على دليل نقل البيانات إلى الواجهة الجديدة.
نقل البيانات إلى Kotlin 2.0
إذا كنت تستخدم حزمة تطوير البرامج (SDK) من Driver لنظام التشغيل Android 6.0 أو إصدار أحدث، عليك الترقية إلى Kotlin 2.0. تقدّم هذه الصفحة إرشادات لتسهيل عملية الانتقال إلى إصدار Kotlin الجديد.
التوافق مع Gradle وAGP
يتطلّب Kotlin 2.0 الحد الأدنى والأقصى من إصدارَي Gradle ومكوّن Gradle الإضافي المتوافق مع Android (AGP). يُرجى التأكّد من أنّ مشروعك يستوفي هذه المتطلبات لاستخدام Kotlin 2.0.
الحد الأدنى من إصدار AGP لحزمة تطوير البرامج (SDK) من Driver 6.0 أو إصدار أحدث
ننصحك باستخدام AGP 7.3 أو إصدار أحدث مع حزمة تطوير البرامج (SDK) من Driver 6.0.
وضع R8 الكامل
لا تتوافق حزمة تطوير البرامج (SDK) من Driver الإصدار 6 أو إصدار أقدم مع وضع R8 الكامل. عليك إيقاف وضع R8 الكامل بشكل صريح إذا كان تطبيقك يستهدف AGP 8.0 أو إصدار أحدث.
# settings.gradle
android.enableR8.fullMode=false
التوافق مع إصدارات Kotlin
تتوافق لغة Kotlin مع ثلاثة إصدارات سابقة من اللغة versions. يعني ذلك أنّه إذا كنت تستخدم Kotlin 1.7 أو إصدار أحدث مع حزمة تطوير البرامج (SDK) من Driver، من المفترض أن تتمكّن من الترقية إلى Kotlin 2.0 بدون الحاجة إلى حلّ جميع التغييرات التي تؤدي إلى حدوث مشاكل. ومع ذلك، لا ينطبق التوافق مع Kotlin إلا على ميزات اللغة الثابتة. إذا كنت تستخدم ميزات ألفا أو بيتا أو ميزات تجريبية في لغة Kotlin، قد تحتاج إلى إجراء تغييرات إضافية عند الترقية.
علامات التوافق مع Kotlin
كما هو موضّح في القسم السابق، تتوافق Kotlin مع ما يصل إلى 3 إصدارات سابقة من اللغة عند الترقية. توفر Kotlin علامتين للمساعدة في الحد من التغييرات التي تؤدي إلى حدوث مشاكل:
language-version X.Y
تعيد هذه العلامة التغييرات التي تؤدي إلى حدوث مشاكل إلى سلوك إصدار Kotlin السابق.
على سبيل المثال، إذا كنت تستخدم Kotlin 1.7، يمكنك تحديد [ -
language-version 1.7] ولن تسري التغييرات الجديدة التي تؤدي إلى حدوث مشاكل:
android {
kotlinOptions {
languageVersion = '1.7'
}
}
api-version X.Y
تمنع هذه العلامة استخدام واجهات برمجة التطبيقات الجديدة قبل أن يصبح الرمز البرمجي التابع الجاهز لدمج Kotlin 2.0.
android {
kotlinOptions {
apiVersion = '1.7'
}
}
نهج أكثر استهدافًا
بالإضافة إلى استخدام علامات التوافق مع Kotlin، ننصحك بمراجعة ملاحظات إصدار Kotlin واختيار السلوكيات التي تريد الاحتفاظ بها من الإصدار الذي تتم الترقية منه. تقدّم Kotlin قائمة بالتغييرات التي قد تؤدي إلى عطل والعلامات التي يمكن ضبطها للاحتفاظ بالسلوك الأصلي في أدلة التوافق لكل إصدار: