إضافة Kotlin Multiplatform إلى مشروع حالي

لإنشاء وحدة Kotlin Multiplatform (KMP) ضمن مشروع Android، استخدِم نموذج وحدة Kotlin Multiplatform المشتركة المتوفّر في Android Studio Meerkat و"المكوّن الإضافي لنظام Gradle المتوافق مع Android" الإصدار 8.8.0 والإصدارات الأحدث.

يعمل نموذج الوحدة على إنشاء وحدة جديدة تلقائيًا باستخدام الحد الأدنى من الإعدادات التي تستهدف منصّتَي Android وiOS.

إعداد وحدة KMP المشتركة

لإنشاء وحدة KMP مشترَكة، اتّبِع الخطوات التالية:

1. اختَر ملف > جديد > وحدة جديدة.
2. اختَر نموذج وحدة مشترَكة لنظام التشغيل Kotlin المتوافق مع أنظمة التشغيل المتعددة في لوحة النماذج:

في ما يلي الحقول الواردة في النموذج:

• اسم الوحدة: يحدِّد اسم وحدة Gradle، بالإضافة إلى اسم إطار عمل iOS (يمكن تغييره لاحقًا).
• اسم الحزمة: يحدِّد اسم الحزمة للملفات في هذه الوحدة.
  1. انقر على إنهاء واسمح لـ Gradle بالمزامنة مع المشروع. قد يُطلب منك أيضًا إضافة ملفات الوحدات التي تم إنشاؤها حديثًا إلى وحدة التحكّم في مصدر العميل.

بعد اكتمال العملية، يعرض عرض المشروع في "استوديو Android" الوحدة المشترَكة الجديدة بالإضافة إلى مجموعة مصادر لكل نظام أساسي.

ربط الوحدة المشترَكة بتطبيق Android

لا يضيف معالج الوحدات الوحدة التي تم إنشاؤها حديثًا كعنصر تابع لأي وحدة حالية. في الخطوة التالية، عليك ربط الوحدة المشترَكة بإحدى وحدات Gradle الحالية تمامًا مثل متطلّبات Android الأخرى.

dependencies {
    ...
    implementation(project(":shared"))
}

بعد تفعيل الميزة، يمكنك الوصول إلى الرمز كالمعتاد. من تطبيق Android، يمكنك الوصول إلى الرمز المتوفّر في androidMain أو في commonMain.

لمزيد من المعلومات عن بنية مشروع Kotlin Multiplatform، اطّلِع على أساسيات بنية مشروع Kotlin Multiplatform.

إعداد الوحدة المشتركة في تطبيق iOS

لا يمكن لغة Swift استخدام وحدات Kotlin مباشرةً، وتتطلّب إنشاء إطار عمل ثنائي compiled.

يضبط نموذج الوحدة الجديد في Android Studio الوحدة المشترَكة لمحاولة إنشاء إطار عمل لكل بنية من بنى iOS. يمكنك العثور على الرمز التالي في ملف build.gradle.kts الخاص بالوحدة المشترَكة:

val xcfName = "sharedKit"

iosX64 {
  binaries.framework {
    baseName = xcfName
  }
}

iosArm64 {
  binaries.framework {
    baseName = xcfName
  }
}

iosSimulatorArm64 {
  binaries.framework {
    baseName = xcfName
  }
}

راجِع هيكل المشروع الهرمي للحصول على معلومات عن تحديد أنواع البنية الأخرى.

ربط المكتبة المشتركة في مشروع iOS

لتفعيل الوصول إلى الرمز المشترَك من مشروع iOS، أضِف مرحلة نص برمجي ل إنشاء إطار عمل Kotlin قبل تجميع مصادر Swift:

1. انقر بزر الماوس الأيمن على الملف في Android Studio واختَر فتح في وفتح في التطبيق المرتبط. سيؤدي ذلك إلى فتح تطبيق iOS في Xcode.

1. افتح إعدادات المشروع عن طريق النقر مرّتين على اسم المشروع في ملف التنقّل بالمشروع.

1. غيِّر الاسم التلقائي Run Script (تشغيل النص البرمجي) إلى Compile Kotlin Framework (تجميع إطار عمل Kotlin) لتحديد دور هذه المرحلة بشكلٍ أفضل. انقر مرّتين على عنوان تشغيل النص البرمجي لتعديله.
2. وسِّع مرحلة الإنشاء، وفي حقل النص Shell، أدخِل رمز الرمز التالي:

1. اسحب مرحلة تشغيل النص البرمجي قبل مرحلة تجميع المصادر.

   

2. يمكنك إنشاء المشروع في Xcode من خلال النقر على ⌘B أو الانتقال إلى قائمة المنتج واختيار إنشاء.

عند نجاح عملية الإنشاء، سيظهر لك الرمز التالي.

الوصول إلى الرمز المشترَك في تطبيق iOS

للتأكّد من أنّ تطبيق iOS يمكنه الوصول إلى الرمز البرمجي من الوحدة المشترَكة بنجاح، يُرجى اتّباع الخطوات التالية:

1. في مشروع iOS، افتح ملف ContentView.swift على الرابط التالي: Sources/View/ContentView.swift
2. أضِف رمز الاستيراد sharedKit في أعلى الملف.
3. عدِّل عرض النص لتضمين معلومات Platform_iosKt.platform() في السلسلة المعروضة على النحو التالي:

يتحقّق هذا التعديل مما إذا كان بإمكان تطبيق Fruitties استدعاء الدالة platform() من الوحدة المشترَكة، والتي من المفترض أن تعرِض "iOS" عند التشغيل على منصة iOS.

مراجع إضافية

إذا كنت مبتدئًا في تطوير تطبيقات KMP، يمكنك الاطّلاع على المستندات الرسمية لـ KMP للحصول على المزيد من الأدلة. إذا كنت مبتدئًا في تطوير تطبيقات iOS، اطّلِع على مستندات Swift الأساسية.