DataStore（Kotlin マルチプラットフォーム）

DataStore ライブラリは、データを非同期的に、一貫した形で、トランザクションとして保存し、SharedPreferences の欠点の一部を解消します。このページでは、Kotlin マルチプラットフォーム（KMP）プロジェクトで DataStore を作成する方法について説明します。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")
}

DataStore クラスを定義する

共有 KMP モジュールの共通ソース内で DataStoreFactory を使用して DataStore クラスを定義できます。これらのクラスを共通のソースに配置すると、すべてのターゲット プラットフォームで共有できます。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"

Android

Android で 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
    }
)