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

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

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

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

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

التوافق بين Gradle وAGP

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

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

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

وضع R8 الكامل

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