تتيح منصة Kotlin المتعدّدة (KMP) مشاركة رموز Kotlin البرمجية على مختلف الأنظمة الأساسية. تم تطوير Kotlin Multiplatform بواسطة JetBrains، واستخدام KMP لاستهداف الأنظمة الأساسية للأجهزة الجوّالة ثابت وجاهز للاستخدام في مرحلة الإنتاج.
مكتبات Jetpack المتوافقة مع الأنظمة الأساسية المتعددة
تتيح Google رسميًا استخدام Kotlin Multiplatform لمشاركة منطق النشاط التجاري بين Android وiOS. تمت نقل العديد من مكتبات Jetpack بالفعل للاستفادة من KMP.
توفّر مكتبات Jetpack التالية إمكانية استخدام KMP:
رقم تعريف مجموعة Maven | آخر الأخبار | الإصدار الثابت | إصدار محتمل | الإصدار التجريبي | الإصدار الأوّلي | المستندات |
---|---|---|---|---|---|---|
التعليق التوضيحي (*) | 7 مايو 2025 | 1.9.1 | - | - | - | |
مجموعة | 12 مارس 2025 | 1.5.0 | - | - | - | |
datastore | 20 مايو 2025 | 1.1.7 | - | - | 1.2.0-alpha02 | المستندات |
رحلة المستخدِم (*) | 2 يوليو 2025 | 2.9.1 | - | - | - | |
تقسيم المحتوى إلى صفحات (*) | 2 يوليو 2025 | 3.3.6 | - | - | 3.4.0-alpha01 | |
room | 18 يونيو 2025 | 2.7.2 | - | - | - | المستندات |
savedstate | 2 يوليو 2025 | 1.3.1 | - | - | - | |
sqlite | 18 يونيو 2025 | 2.5.2 | - | - | - | المستندات |
المستندات المرجعية
تحدّد المستندات المرجعية لهذه المكتبات واجهات برمجة التطبيقات (على سبيل المثال،
DataStoreFactory
) استنادًا إلى مدى توفّرها للرموز البرمجية الشائعة وAndroid وNative. يمكنك أيضًا فلترة البيانات حسب النظام الأساسي في أعلى كل صفحة.
المنصّات المعتمدة
تتضمّن إصدارات مكتبة Jetpack للمنصّتَين المتوافقتَين رسميًا، Android وiOS، متطلبات الجودة والتوافق نفسها. ومع ذلك، بينما نعمل على توسيع نطاق توافق Jetpack مع Kotlin Multiplatform ليشمل منصات أخرى، قد يكون الدعم الخاص بالأدوات والبنية الأساسية قيد التطوير.
يمكن تلخيص مستوى الدعم الحالي لكل منصة في فئات:
المستوى 1:
- تم اختبارها بالكامل في عملية الدمج المتواصل، بما في ذلك الاختبارات التي يتم إجراؤها على الجهاز وعلى المضيف
- تتبُّع التوافق مع المصدر والرمز الثنائي وفقًا لسياساتنا بشأن تحديد الإصدارات الدلالية
المستوى 2:
- تم اختبارها جزئيًا على نظام التكامل المستمر، وهي تقتصر على الاختبارات من جهة المضيف
- لا يتم تتبُّع التوافق مع المصدر أو التوافق الثنائي
المستوى 3:
- لم يتم اختبارها على نظام الدمج المتواصل
- لا يتم تتبُّع التوافق مع المصدر أو التوافق الثنائي
النظام الأساسي | مستوى الدعم |
---|---|
Android | صف 1 |
JVM | صف 1 |
iOS | صف 1 |
نظام التشغيل Mac | صف 2 |
Linux | صف 2 |
watchOS | موظّفو الدعم من المستوى 3 |
tvOS | موظّفو الدعم من المستوى 3 |
نظام التشغيل Windows | موظّفو الدعم من المستوى 3 |
JavaScript | موظّفو الدعم من المستوى 3 |
WASM | موظّفو الدعم من المستوى 3 |
دعم الأدوات
يمكنك فتح مشاريع متعددة المنصات وتعديلها وتشغيلها في "استوديو Android". ومع ذلك، لا تتوفّر بعض ميزات بيئة التطوير المتكاملة (IDE) لهذه المشاريع بعد. لإنشاء مشروع جديد، استخدِم معالج Kotlin Multiplatform من JetBrains، أو يمكنك استخدام المكوّن الإضافي Kotlin Multiplatform في Android Studio.
نحرص أيضًا على ضمان توافق المكوّن الإضافي Android Gradle مع Kotlin Multiplatform من خلال اختبار السيناريوهات الأساسية للإصدارات الجديدة.
مراجع إضافية
يعرض مشروع kotlin-multiplatform-samples بعض وظائف مكتبات Jetpack في مشروع KMP.
الدروس التطبيقية حول بدء استخدام KMP: إرشادات حول كيفية إضافة KMP إلى مشروعك.
الدروس التطبيقية حول نقل Room إلى Room KMP: عملية نقل موجّهة من Room المتوافق مع Android فقط إلى KMP
الملاحظات
إذا كانت لديك ملاحظات حول هذه المكتبات، يمكنك مشاركتها من خلال أداة تتبُّع المشاكل.