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

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

ملاحظة: للحصول على معلومات عن الترقية إلى Kotlin 1.9، وهو الإصدار المطلوب لإصدار Navigation SDK 5.1 والإصدارات الأحدث، يُرجى الاطّلاع على دليل الترقية إلى Kotlin 1.9.

توافق Gradle وAGP

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

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

ننصحك باستخدام AGP 8.3 مع Navigation SDK 6.0. لقد تحقّقنا من حزمة SDK باستخدام AGP 8.3 وGradle 8.4، وتتوافق حزمة SDK مع الوضع الكامل في R8.

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

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

• دليل التوافق مع الإصدار 1.8
• دليل التوافق مع الإصدار 1.9
• دليل التوافق مع الإصدار 2.0