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

DataStore ライブラリは、データを非同期的に、一貫した形で、トランザクションとして保存し、SharedPreferences の欠点の一部を解消します。このページでは、Kotlin マルチプラットフォーム（KMP）プロジェクトで DataStore を作成する方法について説明します。DataStore の詳細については、DataStore のメインのドキュメントと公式サンプルをご覧ください。

依存関係をセットアップする

DataStore は、バージョン 1.1.0 以降で KMP をサポートしています。

KMP プロジェクトで DataStore を設定するには、モジュールの build.gradle.kts ファイルにアーティファクトの依存関係を追加します。

  • androidx.datastore:datastore - DataStore ライブラリ
  • androidx.datastore:datastore-preferences - Preferences DataStore ライブラリ

DataStore クラスを定義する

共有 KMP モジュールの共通ソース内で DataStoreFactory を使用して DataStore クラスを定義できます。これらのクラスを共通ソースに配置すると、すべてのターゲット プラットフォームで共有できます。actual 宣言と expect 宣言を使用して、プラットフォーム固有の実装を作成できます。

DataStore インスタンスを作成する

各プラットフォームで DataStore オブジェクトをインスタンス化する方法を定義する必要があります。これは、ファイル システム API の違いにより、特定のプラットフォーム ソースセットに含める必要がある API の唯一の部分です。

一般

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

DataStore インスタンスを作成するには、ファイルパスとともに Context が必要です。

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

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

iOS

DataStore インスタンスを作成するには、DataStore パスとともに DataStore ファクトリが必要です。

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