Koin Kotlin: पूरी गाइड उदाहरणों के साथ

Koin का परिचय: यह क्या है और क्यों ज़रूरी है

Koin एक हल्का, शक्तिशाली और सहज फ्रेमवर्क है जो Kotlin में Dependency Injection (DI) के लिए उपयोग होता है। Dagger या Spring जैसे भारी समाधानों के विपरीत, Koin रिफ्लेक्शन, एनोटेशन या कोड जनरेशन का उपयोग नहीं करता। यह सब कुछ सरल DSL (Domain Specific Language) कंस्ट्रक्शन पर आधारित है, जिससे कोड साफ, पढ़ने योग्य और आसानी से टेस्ट करने योग्य बनता है।

Koin की ज़रूरत क्यों है? आधुनिक जटिल एप्लिकेशन डेवलपमेंट में क्लासेस के बीच डिपेंडेंसी को मैनेज करना एक मुख्य चुनौती है। DI के बिना, आपको मैन्युअल रूप से ऑब्जेक्ट बनाने होंगे, जिससे कोड टाइट कपलिंग हो जाती है और टेस्टिंग व मेंटेनेंस मुश्किल हो जाता है। Koin इन समस्याओं को हल करता है और डिपेंडेंसी को रजिस्टर, कॉन्फ़िगर और प्राप्त करने का एक सरल तरीका प्रदान करता है।

Koin के मुख्य लाभ:

• हल्का: APK साइज और बिल्ड टाइम पर न्यूनतम प्रभाव।
• सरल: एनोटेशन, रिफ्लेक्शन या कोड जनरेशन की ज़रूरत नहीं।
• Kotlin-first: भाषा की पूरी क्षमताओं का उपयोग (DSL, लैम्ब्डा, कोरूटीन)।
• मॉड्यूलर: डिपेंडेंसी को लॉजिकल मॉड्यूल में बांटने की सुविधा।
• टेस्ट करने योग्य: टेस्ट में डिपेंडेंसी को आसानी से बदला जा सकता है।
• Android सपोर्ट: Android के लिए विशेष मॉड्यूल (ViewModel, Fragment, Compose) उपलब्ध।

Koin की इंस्टॉलेशन

Koin Maven Central के माध्यम से वितरित किया जाता है। प्रोजेक्ट में जोड़ने के लिए build.gradle.kts (या build.gradle) फ़ाइल में डिपेंडेंसी जोड़ें।

Kotlin Multiplatform / JVM प्रोजेक्ट के लिए:

// build.gradle.kts
dependencies {
    // Koin का मुख्य मॉड्यूल
    implementation("io.insert-koin:koin-core:3.5.6")
    
    // टेस्टिंग के लिए
    testImplementation("io.insert-koin:koin-test:3.5.6")
}

Android प्रोजेक्ट के लिए:

// build.gradle.kts (app module)
dependencies {
    // मुख्य मॉड्यूल
    implementation("io.insert-koin:koin-android:3.5.6")
    
    // ViewModel के लिए
    implementation("io.insert-koin:koin-androidx-viewmodel:3.5.6")
    
    // Jetpack Compose के लिए
    implementation("io.insert-koin:koin-androidx-compose:3.5.6")
    
    // WorkManager के लिए
    implementation("io.insert-koin:koin-androidx-workmanager:3.5.6")
    
    // टेस्टिंग के लिए
    testImplementation("io.insert-koin:koin-test:3.5.6")
    testImplementation("io.insert-koin:koin-test-junit5:3.5.6")
}

ध्यान दें: वर्जन बदल सकते हैं। नवीनतम वर्जन हमेशा Koin के GitHub रिपॉजिटरी पर देखें।

Koin के साथ त्वरित शुरुआत

एक सरल उदाहरण देखते हैं: हमारे पास एक UserService है जो UserRepository पर निर्भर करता है। मैन्युअल रूप से रिपॉजिटरी बनाने के बजाय, हम Koin का उपयोग करेंगे।

चरण 1: क्लासेस को परिभाषित करें

// यूज़र रिपॉजिटरी
class UserRepository {
    fun getUsers(): List<String> = listOf("Alice", "Bob", "Charlie")
}

// सर्विस जो रिपॉजिटरी का उपयोग करती है
class UserService(private val repository: UserRepository) {
    fun printUsers() {
        repository.getUsers().forEach { println(it) }
    }
}

चरण 2: Koin मॉड्यूल बनाएं

// मॉड्यूल एक कंटेनर है जहाँ हम बताते हैं कि डिपेंडेंसी कैसे बनाएं
val appModule = module {
    // single — पूरे एप्लिकेशन के लिए एक ही इंस्टेंस बनाएगा (सिंगलटन)
    single<UserRepository> { UserRepository() }
    
    // factory — हर बार रिक्वेस्ट करने पर नया इंस्टेंस बनाएगा
    factory { UserService(get()) } // get() — UserRepository डिपेंडेंसी को रिक्वेस्ट करता है
}

चरण 3: Koin को शुरू करें

// एप्लिकेशन के एंट्री पॉइंट (main या Application) में
fun main() {
    // Koin को हमारे मॉड्यूल के साथ शुरू करें
    startKoin {
        modules(appModule)
    }
    
    // अब हम UserService प्राप्त कर सकते हैं
    val userService: UserService by inject()
    userService.printUsers()
}