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

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

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

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

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

توافق Gradle و"مكوّن Android الإضافي لبرنامج Gradle"

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

الحد الأدنى لإصدار "المكوّن الإضافي لنظام Gradle المتوافق مع Android" لحزمة تطوير البرامج (SDK) لإصدار 6.0 والإصدارات الأحدث

ننصح باستخدام الإصدار 7.3 أو إصدار أحدث من "مكوّن Android الإضافي في Gradle" مع الإصدار 6.0 من Driver SDK.

وضع R8 الكامل

لا تتوافق حزمة تطوير البرامج (SDK) لإصدار برنامج التشغيل 6 والإصدارات الأقدم مع وضع 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 قائمة بالتغييرات غير المتوافقة والأعلام التي يمكن ضبطها للاحتفاظ بالسلوك الأصلي في أدلة التوافق الخاصة بها لكل إصدار: