Configurare DataStore per KMP

La libreria DataStore archivia i dati in modo asincrono, coerente e transazionale, superando alcuni degli svantaggi di SharedPreferences. Questa pagina si concentra sulla creazione di DataStore nei progetti Kotlin Multiplatform (KMP). Per ulteriori informazioni su DataStore, consulta la documentazione principale di DataStore e gli esempi ufficiali.

Configurare le dipendenze

Per configurare DataStore nel tuo progetto KMP, aggiungi le dipendenze per gli artefatti nel file build.gradle.kts per il tuo modulo:

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

Definisci le classi DataStore

Puoi definire la classe DataStore con DataStoreFactory all'interno dell'origine comune del modulo KMP condiviso. Il posizionamento di queste classi in origini comuni consente di condividerle su tutte le piattaforme di destinazione. Puoi utilizzare le dichiarazioni actual e expect per creare implementazioni specifiche per la piattaforma.

Crea l'istanza DataStore

Devi definire come creare un'istanza dell'oggetto DataStore su ogni piattaforma. Questa è l'unica parte dell'API che deve trovarsi nei set di origini specifici della piattaforma a causa delle differenze nelle API del file system.

Comune

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

Per creare l'istanza DataStore su Android, devi disporre di un Context insieme al percorso.

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

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

iOS

Su iOS, puoi recuperare il percorso da 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 (per computer)

Per creare l'istanza DataStore sulla JVM (desktop), fornisci un percorso utilizzando le API Java o 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
    }
)