دليل نقل البيانات في حزمة تطوير البرامج (SDK) 3.0 لتطبيقات Android المخصّصة للمستهلكين

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

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

توافق Gradle وAGP

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

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

تتطلّب حزمة Consumer SDK 3.0 استخدام الإصدار 7.3 أو إصدار أحدث من AGP.

وضع R8 الكامل

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

# settings.gradle
android.enableR8.fullMode=false

توافق إصدارات Kotlin

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