تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

توافق Gradle وAGP

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

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

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

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