توافق إصدارات Kotlin ونقل البيانات

تقدّم هذه الصفحة معلومات عن توافق إصدار Kotlin مع Navigation SDK، بالإضافة إلى إرشادات حول نقل البيانات إلى إصدار أحدث.

يوضّح الجدول التالي متطلبات إصدار Kotlin وإصدارَي IDE وGradle المقترَحين لأحدث إصدارات حزمة Navigation SDK.

إصدار حزمة تطوير البرامج (SDK) للتنقّل إصدار Kotlin (مطلوب) إصدارات المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) وGradle (خيار مُقترَح)
6.2 أو الأحدث 2.1
  • ‫AGP 8.7.3
  • ‫Gradle 8.10.2
‫6.0 - 6.2 2.0
  • AGP 8.3.0
  • ‫Gradle 8.4
5.1 - 5.99.1 1.9 ننصحك باستخدام AGP 7.3 والإصدارات الأحدث، والتي تتضمّن حلًا بديلاً لمشكلة JDK-8272564.

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

يتوافق الإصدار 2.1 من Kotlin مع الإصدار 2.0. وهذا يعني أنّه إذا كنت تستخدِم حاليًا Kotlin 2.0 مع حزمة Navigation SDK، من المفترض أن تتمكّن من الترقية إلى Kotlin 2.1 بدون الحاجة إلى حلّ جميع التغييرات الأساسية. ومع ذلك، لا ينطبق ذلك إلا على ميزات اللغة الثابتة. إذا كنت تستخدِم ميزات تجريبية أو ميزات في مرحلة الإصدار الأولي أو ميزات تجريبية في لغة Kotlin، قد يكون عليك إجراء تغييرات إضافية عند الترقية.

تسهيل عملية النقل: علامات التوافق مع Kotlin

توفّر Kotlin علامتَين للمساعدة في الحد من التغييرات التي تؤدي إلى إيقاف التوافق: https://kotlinlang.org/docs/compatibility-modes.html

language-version X.Y

تؤدي هذه العلامة إلى إعادة التغييرات الأساسية إلى سلوك إصدار Kotlin السابق. على سبيل المثال، إذا كنت تستخدم Kotlin 2.0، يمكنك تحديد [ - language-version 2.0] ولن يتم تطبيق التغييرات الجديدة التي تؤدي إلى إيقاف الإصدارات القديمة:

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

api-version X.Y

تؤدي هذه العلامة إلى ظهور خطأ في إنشاء Gradle عند استخدام واجهة برمجة تطبيقات من إصدار Kotlin أحدث من apiVersion.

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

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

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

ترقيات Kotlin المستقبلية

تطرح Kotlin إصدارًا جديدًا (أي إصدار لغة) كل 6 أشهر وتدمج Google عادةً أحدث إصدار كإصدار تلقائي في منتجاتنا بعد شهر أو شهرَين من ذلك. تضمّنت إصدارات Kotlin السابقة تغييرات جذرية أدّت إلى مطالبة عملاء Navigation SDK بالترقية إلى إصدار أحدث. لهذا السبب، ننصحك بالتخطيط لترقية Kotlin كل 6 أشهر عند استخدام أحدث إصدار من Navigation SDK.