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

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

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

نقل البيانات إلى Kotlin 2.0

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

توافق Gradle وAGP

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

الحد الأدنى لإصدار AGP لحزمة Driver SDK 6.0 والإصدارات الأحدث

ننصحك باستخدام الإصدار 7.3 من AGP والإصدار 6.0 من Driver SDK.

وضع R8 الكامل

لا يتيح الإصدار 6 من حزمة تطوير برامج تشغيل الأجهزة والإصدارات الأقدم وضع R8 الكامل. يجب بشكل صريح إيقاف وضع R8 الكامل إذا كان تطبيقك يستهدف الإصدار 8.0 من Android Graphics API أو الإصدارات الأحدث.

# 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 السابق. على سبيل المثال، إذا كنت تستخدم الإصدار 1.7 من Kotlin، يمكنك تحديد [ - language-version 1.7] ولن يتم تطبيق التغييرات الجديدة التي تؤدي إلى إيقاف الإصدارات القديمة:

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}
api-version X.Y

تمنع هذه العلامة استخدام واجهات برمجة التطبيقات الجديدة قبل أن يصبح الرمز البرمجي المرتبط بها جاهزًا لدمج Kotlin 2.0.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

نهج أكثر استهدافًا

بالإضافة إلى استخدام علامات التوافق مع Kotlin، ننصحك بمراجعة ملاحظات إصدار Kotlin واختيار السلوكيات التي تريد الاحتفاظ بها من الإصدار الذي يتم الترقية منه. توفّر Kotlin قائمة بالتغييرات العميقة والرموز التي يمكن ضبطها للاحتفاظ بالسلوك الأصلي في أدلة التوافق لكل إصدار: