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

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

إذا كنت تستخدِم الإصدار 3.0 أو إصدارًا أحدث من Consumer SDK لنظام التشغيل Android، عليك الترقية إلى 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 استخدام AGP 7.3 أو إصدار أحدث.

وضع R8 الكامل

لا يتيح Consumer SDK الإصدار 3 والإصدارات الأقدم وضع R8 الكامل. عليك إيقاف وضع R8 الكامل بشكلٍ صريح إذا كان تطبيقك يستهدف AGP 8.0 أو إصدارًا أحدث.

# settings.gradle
android.enableR8.fullMode=false

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

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