DataStore 概述与选型

DataStore 是 Android Jetpack 推出的现代化本地持久化解决方案，旨在完全替代 SharedPreferences。它基于 Kotlin 协程与 Flow 构建，提供一致且可预测的异步数据访问，并从根本上解决了 SP 的线程安全、类型不安全、同步阻塞等历史问题。

1.1 DataStore 与 SharedPreferences 对比

下表梳理了两种技术在各关键维度上的差异，以便你快速理解 DataStore 的核心改进点。

1.2 DataStore 两种类型

DataStore 提供两套 API，分别对应不同的结构化复杂度需求。

• Preferences DataStore：轻量键值对存储，API 与 SP 类似但改为挂起/Flow 驱动。适合简单配置项（如开关、字符串、数字）。
• Proto DataStore：基于 protobuf 的强类型存储，数据以定义好的 schema 序列化。适合结构化数据（如用户设置、复合对象）。需定义 .proto 文件和序列化器。

添加依赖（build.gradle.kts）：

// Preferences DataStore
implementation("androidx.datastore:datastore-preferences:1.1.1")

// Proto DataStore
implementation("androidx.datastore:datastore:1.1.1")
implementation("com.google.protobuf:protobuf-javalite:3.25.1")

Preferences 版示例：

// 定义 DataStore 实例
val Context.dataStore: DataStore<Preferences> by preferencesDataStore(name = "settings")

// 读取
val darkMode: Flow<Boolean> = dataStore.data.map { preferences ->
    preferences[PreferencesKeys.DARK_MODE] ?: false
}

// 写入
suspend fun setDarkMode(enabled: Boolean) {
    dataStore.edit { preferences ->
        preferences[PreferencesKeys.DARK_MODE] = enabled
    }
}

object PreferencesKeys {
    val DARK_MODE = booleanPreferencesKey("dark_mode")
}

Proto 版示例（结合定义 proto 文件 UserSettings.proto）：

syntax = "proto3";
option java_package = "com.example.datastore";
option java_multiple_files = true;

message UserSettings {
  bool dark_mode = 1;
  int32 notification_interval = 2;
  string display_name = 3;
}

// 序列化器
object UserSettingsSerializer : Serializer<UserSettings> {
    override val defaultValue = UserSettings.getDefaultInstance()

    override suspend fun readFrom(input: InputStream): UserSettings {
        return UserSettings.parseFrom(input)
    }

    override suspend fun writeTo(t: UserSettings, output: OutputStream) {
        t.writeTo(output)
    }
}

// 实例
val Context.userSettingsDataStore: DataStore<UserSettings> by dataStore(
    fileName = "user_settings.pb",
    serializer = UserSettingsSerializer
)

// 读取
val darkMode: Flow<Boolean> = userSettingsDataStore.data.map { it.darkMode }

// 写入
suspend fun setDarkMode(enabled: Boolean) {
    userSettingsDataStore.updateData { settings ->
        settings.toBuilder().setDarkMode(enabled).build()
    }
}

1.3 适用场景与性能优势

DataStore 在以下场景中优势明显：

• 常规应用设置（主题、语言、通知开关）
• 用户偏好持久化（账号配置、显示偏好）
• 小规模结构化数据（如历史搜索列表缓存）
• 需要实时观察数据变化的 UI 场景

性能优势：