دليل نقل البيانات في الإصدار 6.0 من حزمة تطوير برامج برامج تشغيل Android

الانتقال إلى واجهة DriverStatusListener

في الإصدار 5 من Driver، أعلنّا عن إيقاف واجهة StatusListener نهائيًا واستبدالها بواجهة DriverStatusListener. هذا العام، سنحذف واجهة StatusListener نهائيًا. راجِع مقالة StatusListenerالإيقاف النهائي للحصول على دليل نقل البيانات إلى الواجهة الجديدة.

الانتقال إلى الإصدار 2.0 من Kotlin

إذا كنت تستخدم حزمة تطوير البرامج (SDK) الخاصة بالسائق لنظام التشغيل Android 6.0 والإصدارات الأحدث، عليك الترقية إلى Kotlin 2.0. تقدّم هذه الصفحة إرشادات لتسهيل عملية الانتقال إلى إصدار Kotlin الجديد.

توافق Gradle وAGP

يحتوي الإصدار 2.0 من Kotlin على متطلبات الحد الأدنى والأقصى من الإصدارات لإصدار Gradle والمكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP). تأكَّد من أنّ مشروعك يستوفي المتطلبات التالية لاستخدام Kotlin 2.0.

الحدّ الأدنى لإصدار "المكوّن الإضافي لنظام Gradle المتوافق مع Android" لإصدار Driver SDK 6.0 والإصدارات الأحدث

ننصح باستخدام الإصدار 7.3 من AGP أو إصدار أحدث مع الإصدار 6.0 من حزمة تطوير البرامج (SDK) للسائق.

الوضع الكامل لأداة R8

لا يتوافق الإصدار 6 من حزمة تطوير البرامج (SDK) للسائق والإصدارات الأقدم مع وضع R8 الكامل. يجب إيقاف وضع R8 الكامل بشكل صريح إذا كان تطبيقك يستهدف الإصدار 8.0 من المكوّن الإضافي Android Gradle أو الإصدارات الأحدث.

# settings.gradle
android.enableR8.fullMode=false

التوافق مع إصدارات Kotlin

تتيح لغة Kotlin التوافق مع ثلاثة إصدارات سابقة من اللغة. هذا يعني أنّه إذا كنت تستخدم الإصدار 1.7 أو إصدارًا أحدث من Kotlin مع Driver SDK، من المفترض أن تتمكّن من الترقية إلى الإصدار 2.0 من Kotlin بدون الحاجة إلى حلّ جميع التغييرات غير المتوافقة. ومع ذلك، لا ينطبق توافق 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 قائمة بالتغييرات غير المتوافقة مع الإصدارات السابقة والعلامات التي يمكن ضبطها للاحتفاظ بالسلوك الأصلي في أدلة التوافق لكل إصدار: