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

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

يُوضّح الجدول التالي متطلبات إصدار Kotlin وإصدارَي AGP وGradle المقترَحان للإصدارات الأخيرة من حزمة تطوير البرامج للتنقّل.

إصدار حزمة تطوير البرامج للتنقّل إصدار Kotlin (مطلوب) إصدارا المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) وGradle (مقترَحان)
‫7.3 والإصدارات الأحدث 2.2.10
  • ‫AGP 8.10.0
  • ‫Gradle 8.11.1
‫6.3 - 7.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 ننصحك باستخدام الإصدار 7.3 من AGP أو إصدار أحدث، لأنّه يتضمّن حلاً بديلاً للمشكلة JDK-8272564.

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

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

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

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

‫language-version X.Y

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

android {
   kotlinOptions {
       languageVersion = '2.1'
   }
}

‫api-version X.Y

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

android {
   kotlinOptions {
       apiVersion = '2.1'
   }
}

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

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

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

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