Realm Kotlin: Kotlin के लिए पूर्ण गाइड उदाहरण सहित

1. Realm Kotlin क्या है और इसकी आवश्यकता क्यों है?

Realm Kotlin एक आधुनिक, तेज़ और ऑब्जेक्ट-ओरिएंटेड मोबाइल डेटाबेस है, जिसे विशेष रूप से Kotlin Multiplatform (KMP) इकोसिस्टम के लिए बनाया गया है। पारंपरिक समाधानों जैसे SQLite या Room के विपरीत, Realm टेबल और पंक्तियों के साथ काम नहीं करता, बल्कि सीधे Kotlin ऑब्जेक्ट्स के साथ काम करता है। इसका मतलब है कि आप डेटा के साथ उसी तरह काम करते हैं जैसे सामान्य क्लासेस के साथ, बिना SQL क्वेरी लिखने या मैन्युअली डेटा मैप करने की आवश्यकता के। Realm Kotlin, Java के लिए लोकप्रिय Realm लाइब्रेरी का सीधा उत्तराधिकारी है, लेकिन इसे Kotlin के लिए पूरी तरह से नए सिरे से लिखा गया है, जो कोरूटीन, Flow और मल्टीप्लेटफ़ॉर्म (Android, iOS, macOS, JVM) को सपोर्ट करता है।

इसकी आवश्यकता क्यों है? सबसे पहले, मोबाइल ऐप डेवलपमेंट को तेज़ करने के लिए। Realm लोकल स्टोरेज के साथ काम करते समय बॉयलरप्लेट कोड (boilerplate) की मात्रा को कम करता है। आप बस एक डेटा मॉडल घोषित करते हैं, और Realm ऑब्जेक्ट्स को सेव, रीड, अपडेट और डिलीट करने के लिए आवश्यक सब कुछ ऑटोमैटिकली जनरेट करता है। रिएक्टिव स्ट्रीम्स (kotlinx.coroutines से Flow) के बिल्ट-इन सपोर्ट के कारण, डेटाबेस में कोई भी बदलाव तुरंत UI में दिखाई देता है, जो MVVM आर्किटेक्चर के लिए आदर्श है। Realm अपनी उच्च परफॉरमेंस के लिए भी जाना जाता है: यह अपने खुद के C++ इंजन पर चलता है, जो नेटिव के करीब रीड और राइट स्पीड प्रदान करता है।

मुख्य उपयोग के मामले: सर्वर से डेटा कैशिंग करना, ऑफलाइन मोड में काम करना, जटिल नेस्टेड स्ट्रक्चर (जैसे ई-कॉमर्स कार्ट या चैट हिस्ट्री) को स्टोर करना, और Realm Sync (MongoDB Atlas क्लाउड सर्विस) के माध्यम से उपकरणों के बीच डेटा सिंक करना। Realm Kotlin सिर्फ "एक और ORM" नहीं है, यह एक पूर्ण डेटाबेस इंजन है जो ऐप में स्टेट मैनेजमेंट के दृष्टिकोण को बदल देता है।

2. इंस्टॉलेशन

Realm Kotlin को Gradle बिल्ड सिस्टम के माध्यम से इंस्टॉल किया जाता है। चूंकि लाइब्रेरी Kotlin Multiplatform के लिए है, इसलिए इसका कॉन्फ़िगरेशन मानक Android डिपेंडेंसी से थोड़ा अलग है।

महत्वपूर्ण: Realm Kotlin pip (Python) या npm (JavaScript) के माध्यम से इंस्टॉल नहीं होता। यह JVM/Android/iOS के लिए एक नेटिव लाइब्रेरी है।

अपनी रूट build.gradle.kts फ़ाइल (Project-level) में निम्नलिखित कोड जोड़ें:

// रूट build.gradle.kts
plugins {
    id("io.realm.kotlin") version "1.16.0" apply false
}

फिर अपने मॉड्यूल (app या shared) की build.gradle.kts फ़ाइल में:

// मॉड्यूल का build.gradle.kts
plugins {
    kotlin("multiplatform")
    id("io.realm.kotlin")
}

kotlin {
    // टार्गेट सेट करें (Android, iOS आदि)
    androidTarget()
    listOf(
        iosX64(),
        iosArm64(),
        iosSimulatorArm64()
    ).forEach {
        it.binaries.framework {
            baseName = "shared"
        }
    }

    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation("io.realm.kotlin:library-base:1.16.0")
                // कोरूटीन सपोर्ट के लिए
                implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.8.0")
            }
        }
        // ... अन्य source sets
    }
}

सिर्फ Android प्रोजेक्ट (KMP के बिना) के लिए कॉन्फ़िगरेशन सरल है:

// build.gradle.kts (Module :app)
plugins {
    id("com.android.application")
    kotlin("android")
    id("io.realm.kotlin")
}

android {
    // ... मानक सेटिंग्स
}

dependencies {
    implementation("io.realm.kotlin:library-base:1.16.0")
}

Gradle सिंक करने के बाद लाइब्रेरी उपयोग के लिए तैयार है।