Настройка DataStore для KMP

Библиотека DataStore хранит данные асинхронно, согласованно и транзакционно, преодолевая некоторые недостатки SharedPreferences. Эта страница посвящена созданию DataStore в проектах Kotlin Multiplatform (KMP). Подробнее о DataStore см. в основной документации по DataStore и официальных примерах .

Настройка зависимостей

Чтобы настроить DataStore в вашем проекте KMP, добавьте зависимости для артефактов в файле build.gradle.kts для вашего модуля:

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

Определить классы DataStore

Вы можете определить класс DataStore с помощью DataStoreFactory внутри общего исходного кода вашего общего модуля KMP. Размещение этих классов в общих исходных кодах позволяет использовать их на всех целевых платформах. Для создания платформенно-специфичных реализаций можно использовать объявления actual и expect .

Создайте экземпляр DataStore

Вам необходимо определить, как создавать экземпляр объекта DataStore на каждой платформе. Это единственная часть API, которая должна присутствовать в исходных наборах конкретной платформы из-за различий в API файловых систем.

Общий 

// 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"

Андроид

Чтобы создать экземпляр DataStore на Android, вам понадобится Context вместе с путем.

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

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

iOS

В iOS вы можете получить путь из 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 (для настольных компьютеров)

Чтобы создать экземпляр DataStore на JVM (для настольных ПК), укажите путь с помощью API Java или 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
    }
)