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

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

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

توافق Gradle وAGP

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

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

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

توافق إصدار Kotlin

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