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

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

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

إصدار حزمة تطوير البرامج (SDK) للتنقّل إصدار Kotlin (مطلوب) إصدارات المكوّن الإضافي لنظام Gradle المتوافق مع Android ‏ (AGP) وGradle (خيار مُقترَح)
8.0+ 2.3.0
  • الإصدار 9.0.1 من AGP
  • الإصدار 9.1.0 من Gradle

ملاحظة مهمة: بالنسبة إلى الإصدار 8.0 من حزمة تطوير البرامج (SDK) للتنقّل والإصدارات الأحدث، يُعدّ الإصدار 9.0.1 من AGP الحد الأدنى من المتطلبات وليس مجرد اقتراح. تُعلن حزمة SDK عن minAndroidGradlePluginVersion=9.0.1، وتتعذّر عمليات الإنشاء التي تستخدم إصدارًا سابقًا من AGP.

7.7 - 7.9 2.3.0
  • الإصدار 8.13.2 من AGP
  • ‫Gradle 8.13
7.3 - 7.6 2.2.10
  • ‫AGP 8.10.0
  • ‫Gradle 8.11.1
6.3 - 7.2 2.1
  • الإصدار 8.7.3 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android"
  • ‫Gradle 8.10.2
6.0 - 6.2 2.0
  • الإصدار 8.3.0 من AGP
  • ‫Gradle 8.4
5.1 - 5.99.1 1.9 ننصحك باستخدام الإصدار 7.3 من AGP أو الإصدارات الأحدث، والذي يتضمّن حلاً بديلاً للمشكلة JDK-8272564.

التوافق مع إصدارات Kotlin

يدعم الإصدار 2.3 من Kotlin التوافق مع الأنظمة القديمة مع الإصدار 2.2 من Kotlin. هذا يعني أنّه إذا كنت تستخدم Kotlin 2.2 مع حزمة تطوير البرامج (SDK) للتنقّل، من المفترض أن تتمكّن من الترقية إلى Kotlin 2.3 بدون الحاجة إلى حلّ جميع التغييرات التي قد تؤدي إلى عطل. ومع ذلك، ينطبق هذا فقط على ميزات اللغة الثابتة. إذا كنت تستخدم ميزات أولية أو تجريبية في لغة Kotlin، قد تحتاج إلى إجراء تغييرات إضافية عند الترقية.

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

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

language-version X.Y

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

android {
   kotlinOptions {
       languageVersion = '2.2'
   }
}

api-version X.Y

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

android {
   kotlinOptions {
       apiVersion = '2.2'
   }
}

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

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

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

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