DataStore लाइब्रेरी, डेटा को एसिंक्रोनस तरीके से, लगातार, और शेयर किए गए डेटा की कमियों को दूर करने के लिए, लेन-देन के तौर पर इनका इस्तेमाल किया जा सकता है. यह यह पेज, Kotlin Multiplatform (KMP) प्रोजेक्ट में DataStore बनाने पर फ़ोकस करता है. DataStore के बारे में ज़्यादा जानकारी के लिए, इसे देखें DataStore के लिए मुख्य दस्तावेज़ और आधिकारिक सैंपल.
डिपेंडेंसी सेट अप करना
DataStore, KMP के 1.1.0 और इसके बाद के वर्शन पर काम करता है.
अपने KMP प्रोजेक्ट में DataStore सेट अप करने के लिए, आर्टफ़ैक्ट के लिए डिपेंडेंसी जोड़ें
build.gradle.kts
फ़ाइल में अपने मॉड्यूल के लिए:
androidx.datastore:datastore
- DataStore लाइब्रेरीandroidx.datastore:datastore-preferences
- प्राथमिकताओं की DataStore लाइब्रेरी
DataStore क्लास तय करें
DataStore
क्लास को कॉमन के अंदर DataStoreFactory
से तय किया जा सकता है
सोर्स के तौर पर मिला है. इन क्लास को कॉमन सोर्स में शामिल करना
को टारगेट किए गए सभी प्लैटफ़ॉर्म पर शेयर किया जा सकता है. Google Analytics 4 पर माइग्रेट करने के लिए,
actual
और expect
एलान करना होगा
प्लैटफ़ॉर्म के हिसाब से लागू किया जाता है.
DataStore इंस्टेंस बनाएं
आपको हर प्लैटफ़ॉर्म पर DataStore ऑब्जेक्ट को इंस्टैंशिएट करने का तरीका तय करना होगा. एपीआई का सिर्फ़ यही एक हिस्सा है, जिसका किसी खास प्लैटफ़ॉर्म में होना ज़रूरी है सोर्स सेट शामिल हैं.
सामान्य
// shared/src/androidMain/kotlin/createDataStore.kt
/**
* Gets the singleton DataStore instance, creating it if necessary.
*/
fun createDataStore(producePath: () -> String): DataStore<Preferences> =
PreferenceDataStoreFactory.createWithPath(
produceFile = { producePath().toPath() }
)
internal const val dataStoreFileName = "dice.preferences_pb"
Android
DataStore
इंस्टेंस बनाने के लिए, आपको एक Context
की साथ में
फ़ाइल पाथ.
// shared/src/androidMain/kotlin/createDataStore.android.kt
fun createDataStore(context: Context): DataStore<Preferences> = createDataStore(
producePath = { context.filesDir.resolve(dataStoreFileName).absolutePath }
)
iOS
DataStore इंस्टेंस बनाने के लिए, आपको डेटाबेस पाथ.
// shared/src/iosMain/kotlin/createDataStore.kt
fun createDataStore(): DataStore<Preferences> = createDataStore(
producePath = {
val documentDirectory: NSURL? = NSFileManager.defaultManager.URLForDirectory(
directory = NSDocumentDirectory,
inDomain = NSUserDomainMask,
appropriateForURL = null,
create = false,
error = null,
)
requireNotNull(documentDirectory).path + "/$dataStoreFileName"
}
)