DataStore für KMP einrichten

Die DataStore-Bibliothek speichert Daten asynchron, konsistent und transaktionsorientiert und behebt so einige der Nachteile von SharedPreferences. Auf dieser Seite wird das Erstellen von DataStore in Kotlin Multiplatform-Projekten (KMP) behandelt. Weitere Informationen zu DataStore finden Sie in der Hauptdokumentation zu DataStore und in den offiziellen Beispielen.

Abhängigkeiten einrichten

Wenn Sie DataStore in Ihrem KMP-Projekt einrichten möchten, fügen Sie die Abhängigkeiten für die Artefakte in der Datei build.gradle.kts für Ihr Modul hinzu:

commonMain.dependencies {
  // DataStore library
  implementation("androidx.datastore:datastore:1.2.1")
  // The Preferences DataStore library
  implementation("androidx.datastore:datastore-preferences:1.2.1")
}

DataStore-Klassen definieren

Sie können die Klasse DataStore mit DataStoreFactory in der gemeinsamen Quelle Ihres freigegebenen KMP-Moduls definieren. Wenn Sie diese Klassen in gemeinsamen Quellen platzieren, können sie auf allen Zielplattformen freigegeben werden. Sie können actual und expect Deklarationen verwenden, um plattformspezifische Implementierungen zu erstellen.

DataStore-Instanz erstellen

Sie müssen definieren, wie das DataStore-Objekt auf jeder Plattform instanziiert werden soll. Dies ist der einzige Teil der API, der aufgrund der Unterschiede in den Dateisystem-APIs in den spezifischen Quellsätzen der Plattform enthalten sein muss.

Verbreitet

// shared/src/commonMain/kotlin/createDataStore.kt

/**
 *   Gets the singleton DataStore instance, creating it if necessary.
 */
fun createDataStore(storage: Storage<Preferences>): DataStore<Preferences> =
        DataStoreFactory.create(storage = storage)

internal const val dataStoreFileName = "dice.preferences_pb"

Android

Um die DataStore-Instanz unter Android zu erstellen, benötigen Sie einen Context zusammen mit dem Pfad.

// shared/src/androidMain/kotlin/createDataStore.android.kt

fun createDataStore(): DataStore<Preferences> = createDataStore(
    storage = FileStorage(
        serializer = PreferencesSerializer,
        produceFile = { context.filesDir.resolve(dataStoreFileName) }
    )
)

iOS

Unter iOS können Sie den Pfad aus dem NSDocumentDirectory abrufen:

// shared/src/iosMain/kotlin/createDataStore.ios.kt

fun createDataStore(): DataStore<Preferences> = createDataStore(
    storage = OkioStorage(
        fileSystem = FileSystem.SYSTEM,
        serializer = PreferencesSerializer,
        producePath = {
            val documentDirectory: NSURL? = NSFileManager.defaultManager.URLForDirectory(
                directory = NSDocumentDirectory,
                inDomain = NSUserDomainMask,
                appropriateForURL = null,
                create = false,
                error = null,
            )
            (requireNotNull(documentDirectory).path + "/$dataStoreFileName").toPath()
        }
    )
)

Web

Um die DataStore-Instanz im Web zu erstellen, können Sie WebLocalStorage oder WebSessionStorage verwenden:

// shared/src/jsMain/kotlin/createDataStore.web.kt (also works for wasmJsMain)

fun createDataStore(): DataStore<Preferences> = createDataStore(
    storage = WebLocalStorage(
        serializer = PreferencesSerializer,
        name = dataStoreFileName
    )
)

JVM (Desktop)

Um die DataStore-Instanz auf der JVM (Desktop) zu erstellen, geben Sie einen Pfad mit Java- oder Kotlin-APIs an:

// shared/src/jvmMain/kotlin/createDataStore.desktop.kt

fun createDataStore(): DataStore<Preferences> = createDataStore(
    storage = FileStorage(
        serializer = PreferencesSerializer,
        produceFile = { File(System.getProperty("java.io.tmpdir"), dataStoreFileName) }
    )
)