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

إذا كنت تستخدِم حزمة تطوير البرامج Navigation 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 والإصدارات الأحدث

ننصحك باستخدام الإصدار 7.3 من AGP والإصدار 6.0 من حزمة Navigation SDK. لقد تحققنا من حزمة 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 السابق. على سبيل المثال، إذا كنت تستخدم Kotlin 1.7، يمكنك تحديد [ - language-version 1.7] ولن تسري التغييرات الجديدة التي قد تؤدي إلى أعطال:

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}

إصدار واجهة برمجة التطبيقات X.Y

تمنع هذه العلامة استخدام واجهات برمجة التطبيقات الجديدة قبل أن يصبح الرمز البرمجي المرتبط بها جاهزًا لدمج Kotlin 2.0.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

نهج أكثر استهدافًا

بالإضافة إلى استخدام علامات التوافق مع Kotlin، ننصحك بمراجعة ملاحظات إصدار Kotlin واختيار السلوكيات التي تريد الاحتفاظ بها من الإصدار الذي يتم الترقية منه. توفر لغة Kotlin قائمة بالتغييرات التي قد تؤدي إلى أعطال في الموقع الإلكتروني وعلامة العلامات التي يمكن ضبطها للاحتفاظ بالسلوك الأصلي في أدلة التوافق لكل إصدار:

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