DataStore (Kotlin Multiplatform)

Biblioteka DataStore przechowuje dane asynchronicznie, konsekwentnie i transakcyjnie, co eliminuje niektóre wady SharedPreferences. Ta strona skupia się na tworzeniu DataStore w projektach Kotlin Multiplatform (KMP). Więcej informacji o DataStore znajdziesz w głównej dokumentacji DataStore i oficjalnych przykładach.

Konfigurowanie zależności

Aby skonfigurować DataStore w projekcie KMP, dodaj zależności artefaktów w pliku build.gradle.kts dla modułu:

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

Definiowanie klas DataStore

Klasę DataStore możesz zdefiniować za pomocą funkcji DataStoreFactory w commonsource udostępnionego modułu KMP. Umieszczenie tych zajęć w powszechnie dostępnych źródłach umożliwia ich udostępnianie na wszystkich platformach docelowych. Aby tworzyć implementacje dla poszczególnych platform, możesz używać deklaracji actual i expect.

Tworzenie instancji DataStore

Musisz określić, jak tworzyć instancje obiektu DataStore na każdej platformie. Jest to jedyna część interfejsu API, która musi znajdować się w konkretnych zestawach źródeł platformy z powodu różnic w interfejsach API systemu plików.

Częste

// shared/src/commonMain/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

Aby utworzyć instancję DataStore na urządzeniu z Androidem, musisz mieć Context wraz ze ścieżką.

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

fun createDataStore(context: Context): DataStore<Preferences> = createDataStore(
    producePath = { context.filesDir.resolve(dataStoreFileName).absolutePath }
)

iOS

W iOS możesz pobrać ścieżkę z NSDocumentDirectory:

// shared/src/iosMain/kotlin/createDataStore.ios.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"
    }
)

JVM (komputera stacjonarnego)

Aby utworzyć instancję DataStore w JVM (na komputerze), podaj ścieżkę za pomocą interfejsów API Java lub Kotlin:

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

fun createDataStore(): DataStore<Preferences> = createDataStore(
    producePath = {
      val file = File(System.getProperty("java.io.tmpdir"), dataStoreFileName)
      file.absolutePath
    }
)