Koin لـ Kotlin: دليل شامل مع أمثلة

مقدمة في Koin: ما هو ولماذا تحتاجه

Koin هو إطار عمل خفيف وقوي وبديهي لحقن التبعيات (Dependency Injection, DI) في Kotlin. على عكس الحلول الثقيلة مثل Dagger أو Spring، لا يستخدم Koin الانعكاس (Reflection) أو التعليقات التوضيحية (Annotations) أو توليد الكود. كل شيء مبني على تركيبات DSL بسيطة (لغة خاصة بالمجال)، مما يجعل الكود نظيفًا وقابلًا للقراءة وسهل الاختبار.

لماذا تحتاج Koin؟ في تطوير التطبيقات المعقدة الحديثة، تعد إدارة التبعيات بين الفئات إحدى المهام الرئيسية. بدون DI، ستقوم بإنشاء الكائنات يدويًا، مما يؤدي إلى ترابط قوي في الكود، ويعقد الاختبار والصيانة. يحل Koin هذه المشكلات من خلال توفير طريقة بسيطة لتسجيل التبعيات وتكوينها والحصول عليها.

المزايا الرئيسية لـ Koin:

\n
• الخفة: تأثير ضئيل على حجم APK ووقت البناء.
\n
• البساطة: لا يتطلب تعليقات توضيحية أو انعكاسًا أو توليد كود.
\n
• أولوية Kotlin: يستخدم بالكامل إمكانيات اللغة (DSL، لامبدا، كوروتينات).
\n
• النمطية: يسمح بتقسيم التبعيات إلى وحدات منطقية.
\n
• قابلية الاختبار: سهولة استبدال التبعيات في الاختبارات.
\n
• دعم Android: يحتوي على وحدات خاصة لنظام Android (ViewModel، Fragment، Compose).
\n

تثبيت Koin

يتم توزيع Koin عبر Maven Central. للربط بالمشروع، أضف التبعيات إلى ملف build.gradle.kts (أو build.gradle).

لمشروع Kotlin Multiplatform / JVM:

// build.gradle.kts\ndependencies {\n    // الوحدة الأساسية لـ Koin\n    implementation("io.insert-koin:koin-core:3.5.6")\n    \n    // للاختبار\n    testImplementation("io.insert-koin:koin-test:3.5.6")\n}

لمشروع Android:

// build.gradle.kts (وحدة التطبيق)\ndependencies {\n    // الوحدة الأساسية\n    implementation("io.insert-koin:koin-android:3.5.6")\n    \n    // لـ ViewModel\n    implementation("io.insert-koin:koin-androidx-viewmodel:3.5.6")\n    \n    // لـ Jetpack Compose\n    implementation("io.insert-koin:koin-androidx-compose:3.5.6")\n    \n    // لـ WorkManager\n    implementation("io.insert-koin:koin-androidx-workmanager:3.5.6")\n    \n    // للاختبار\n    testImplementation("io.insert-koin:koin-test:3.5.6")\n    testImplementation("io.insert-koin:koin-test-junit5:3.5.6")\n}

هام: قد تتغير الإصدارات. يمكنك دائمًا التحقق من الإصدار الحالي على مستودع Koin على GitHub.

بداية سريعة مع Koin

لننظر إلى مثال بسيط: لدينا خدمة UserService تعتمد على UserRepository. بدلاً من إنشاء المستودع يدويًا، نستخدم Koin.

الخطوة 1: تعريف الفئات

// مستودع المستخدمين\nclass UserRepository {\n    fun getUsers(): List<String> = listOf("Alice", "Bob", "Charlie")\n}\n\n// الخدمة التي تستخدم المستودع\nclass UserService(private val repository: UserRepository) {\n    fun printUsers() {\n        repository.getUsers().forEach { println(it) }\n    }\n}

الخطوة 2: إنشاء وحدة Koin

// الوحدة — هي حاوية نصف فيها كيفية إنشاء التبعيات\nval appModule = module {\n    // single — سينشئ مثيلًا واحدًا للتطبيق بأكمله (مفرد)\n    single<UserRepository> { UserRepository() }\n    \n    // factory — سينشئ مثيلًا جديدًا في كل طلب\n    factory { UserService(get()) } // get() — يطلب التبعية UserRepository\n}

الخطوة 3: تشغيل Koin

// في نقطة دخول التطبيق (main أو Application)\nfun main() {\n    // تشغيل Koin