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

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

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

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

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

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

يتطلّب الإصدار 3.0 من حزمة تطوير البرامج (SDK) للمستهلكين استخدام الإصدار 7.3 أو إصدار أحدث من "مكوّن Android الإضافي لبرنامج Gradle".

وضع R8 الكامل

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

# settings.gradle
android.enableR8.fullMode=false

التوافق مع إصدارات Kotlin

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