DataStore āϞāĻžāĻāĻŦā§āϰā§āϰāĻŋ āĻļā§āϝāĻŧāĻžāϰāĻĄāĻĒā§āϰā§āĻĢāĻžāϰā§āύā§āϏā§āϰ āĻāĻŋāĻā§ āϤā§āϰā§āĻāĻŋ āĻāĻžāĻāĻŋāϝāĻŧā§ āĻ āϏāĻŋāĻā§āĻā§āϰā§āύāĻžāϏāĻāĻžāĻŦā§, āϧāĻžāϰāĻžāĻŦāĻžāĻšāĻŋāĻāĻāĻžāĻŦā§ āĻāĻŦāĻ āϞā§āύāĻĻā§āύāĻāϤāĻāĻžāĻŦā§ āĻĄā§āĻāĻž āϏāĻā§āĻāϝāĻŧ āĻāϰā§āĨ¤ āĻāĻ āĻĒā§āώā§āĻ āĻžāĻāĻŋ āĻā§āĻāϞāĻŋāύ āĻŽāĻžāϞā§āĻāĻŋāĻĒā§āϞā§āϝāĻžāĻāĻĢāϰā§āĻŽ (KMP) āĻĒā§āϰāĻāϞā§āĻĒāĻā§āϞāĻŋāϤ⧠āĻĄā§āĻāĻžāϏā§āĻā§āϰ āϤā§āϰāĻŋāϰ āĻāĻĒāϰ āĻĻā§āώā§āĻāĻŋ āύāĻŋāĻŦāĻĻā§āϧ āĻāϰā§ā§ˇ DataStore āϏāĻŽā§āĻĒāϰā§āĻā§ āĻāϰāĻ āϤāĻĨā§āϝā§āϰ āĻāύā§āϝ, DataStore āĻāĻŦāĻ āĻ āĻĢāĻŋāϏāĻŋāϝāĻŧāĻžāϞ āύāĻŽā§āύāĻžāϰ āĻĒā§āϰāĻžāĻĨāĻŽāĻŋāĻ āĻĄāĻā§āĻŽā§āύā§āĻā§āĻļāύ āĻĻā§āĻā§āύāĨ¤
āύāĻŋāϰā§āĻāϰāϤāĻž āϏā§āĻ āĻāĻĒ āĻāϰā§āύ
āĻāĻĒāύāĻžāϰ KMP āĻĒā§āϰā§āĻā§āĻā§āĻā§ DataStore āϏā§āĻ āĻāĻĒ āĻāϰāϤā§, āĻāĻĒāύāĻžāϰ āĻŽāĻĄāĻŋāĻāϞā§āϰ āĻāύā§āϝ 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")
}
āĻĄā§āĻāĻžāϏā§āĻā§āϰ āĻā§āϞāĻžāϏ āϏāĻāĻā§āĻāĻžāϝāĻŧāĻŋāϤ āĻāϰā§āύ
āĻāĻĒāύāĻŋ āĻāĻĒāύāĻžāϰ āĻāĻžāĻ āĻāϰāĻž KMP āĻŽāĻĄāĻŋāĻāϞā§āϰ āϏāĻžāϧāĻžāϰāĻŖ āĻā§āϏā§āϰ āĻāĻŋāϤāϰ⧠DataStoreFactory
āĻĻāĻŋāϝāĻŧā§ DataStore
āĻā§āϞāĻžāϏ āϏāĻāĻā§āĻāĻžāϝāĻŧāĻŋāϤ āĻāϰāϤ⧠āĻĒāĻžāϰā§āύāĨ¤ āϏāĻžāϧāĻžāϰāĻŖ āĻāϤā§āϏāĻā§āϞāĻŋāϤ⧠āĻāĻ āĻā§āϞāĻžāϏāĻā§āϞāĻŋ āϏā§āĻĨāĻžāĻĒāύ āĻāϰāĻž āϤāĻžāĻĻā§āϰ āϏāĻŽāϏā§āϤ āϞāĻā§āώā§āϝ āĻĒā§āϞā§āϝāĻžāĻāĻĢāϰā§āĻŽ āĻā§āĻĄāĻŧā§ āĻāĻžāĻ āĻāϰāĻžāϰ āĻ
āύā§āĻŽāϤāĻŋ āĻĻā§āϝāĻŧ⧎ āĻāĻĒāύāĻŋ āĻĒā§āϞā§āϝāĻžāĻāĻĢāϰā§āĻŽ-āύāĻŋāϰā§āĻĻāĻŋāώā§āĻ āĻŦāĻžāϏā§āϤāĻŦāĻžāϝāĻŧāύ āϤā§āϰāĻŋ āĻāϰāϤ⧠actual
āĻāĻŦāĻ expect
āĻā§āώāĻŖāĻž āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻāϰāϤ⧠āĻĒāĻžāϰā§āύāĨ¤
āĻĄā§āĻāĻžāϏā§āĻā§āϰ āĻāĻĻāĻžāĻšāϰāĻŖ āϤā§āϰāĻŋ āĻāϰā§āύ
āĻĒā§āϰāϤāĻŋāĻāĻŋ āĻĒā§āϞā§āϝāĻžāĻāĻĢāϰā§āĻŽā§ āĻĄā§āĻāĻžāϏā§āĻā§āϰ āĻ āĻŦāĻā§āĻā§āĻāĻāĻŋ āĻā§āĻāĻžāĻŦā§ āĻāύāϏā§āĻā§āϝāĻžāύā§āĻ āĻāϰāĻž āϝāĻžāϝāĻŧ āϤāĻž āĻāĻĒāύāĻžāĻā§ āϏāĻāĻā§āĻāĻžāϝāĻŧāĻŋāϤ āĻāϰāϤ⧠āĻšāĻŦā§āĨ¤ āĻāĻāĻŋ 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
āĻāύāϏā§āĻā§āϝāĻžāύā§āϏ āϤā§āϰāĻŋ āĻāϰāϤā§, āĻāĻĒāύāĻžāϰ āĻĒāĻĨā§āϰ āϏāĻžāĻĨā§ āĻāĻāĻāĻŋ 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 (āĻĄā§āϏā§āĻāĻāĻĒ)
JVM (āĻĄā§āϏā§āĻāĻāĻĒ) āĻ DataStore
āĻāĻĻāĻžāĻšāϰāĻŖ āϤā§āϰāĻŋ āĻāϰāϤā§, Java āĻŦāĻž Kotlin API āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻāϰ⧠āĻāĻāĻāĻŋ āĻĒāĻĨ āĻĒā§āϰāĻĻāĻžāύ āĻāϰā§āύ:
// shared/src/jvmMain/kotlin/createDataStore.desktop.kt
fun createDataStore(): DataStore<Preferences> = createDataStore(
producePath = {
val file = File(System.getProperty("java.io.tmpdir"), dataStoreFileName)
file.absolutePath
}
)