2024年末Android应用设置持久化的标准方案是什么？

针对你用Jetpack Compose自定义了设置UI、需要持久化开关等配置的场景，当前官方推荐的稳定方案是Jetpack DataStore 的 Proto DataStore，以下是具体说明和实现思路：

一、为什么选Proto DataStore #

• 它是当前Jetpack生态中唯一稳定且未被弃用的偏好存储方案，替代了已弃用的SharedPreferences和PreferencesDataStore。
• 类型安全：通过Protocol Buffers定义设置结构，彻底避免键值对存储的类型错误。
• 完全独立于UI：和你已有的Compose设置界面完全解耦，仅负责数据持久化逻辑。
• 原生支持协程与Flow：天然适配Compose的状态监听机制，能自动同步设置变更到UI。

二、实现步骤 #

1. 添加Gradle依赖 #

在模块级build.gradle.kts中配置依赖与ProtoBuf插件：

dependencies {
    // DataStore核心依赖
    implementation("androidx.datastore:datastore:1.1.1")
    // ProtoBuf轻量版依赖
    implementation("com.google.protobuf:protobuf-javalite:3.25.3")
}

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("com.google.protobuf") version "0.9.4"
}

protobuf {
    protoc {
        artifact = "com.google.protobuf:protoc:3.25.3"
    }
    generateProtoTasks {
        all().forEach { task ->
            task.builtins {
                create("java") {
                    option("lite")
                }
            }
        }
    }
}

2. 定义Proto数据结构 #

在src/main/proto目录下创建user_preferences.proto，描述你的设置项：

syntax = "proto3";

option java_package = "com.yourpackage.app";
option java_multiple_files = true;

message UserPreferences {
    bool dark_mode_enabled = 1;
    bool notifications_enabled = 2;
}

3. 创建DataStore管理类 #

实现单例DataStore实例与数据读写逻辑：

import androidx.datastore.core.DataStore
import androidx.datastore.dataStore
import com.yourpackage.app.UserPreferences
import kotlinx.coroutines.flow.Flow
import kotlinx.coroutines.flow.map

// 全局DataStore实例
val Context.dataStore: DataStore<UserPreferences> by dataStore(
    fileName = "user_preferences.pb",
    serializer = UserPreferencesSerializer
)

// 数据仓库类
class UserPreferencesRepository(private val dataStore: DataStore<UserPreferences>) {
    // 读取深色模式开关状态的Flow
    val darkModeEnabled: Flow<Boolean> = dataStore.data
        .map { preferences ->
            preferences.darkModeEnabled ?: false
        }

    // 更新深色模式开关状态
    suspend fun setDarkModeEnabled(enabled: Boolean) {
        dataStore.updateData { preferences ->
            preferences.toBuilder()
                .setDarkModeEnabled(enabled)
                .build()
        }
    }
}

// 在Application类中初始化仓库
class MyApp : Application() {
    val userPreferencesRepository by lazy {
        UserPreferencesRepository(dataStore)
    }
}

4. 在Compose UI中集成 #

在自定义设置界面中监听并更新状态：

@Composable
fun SettingsScreen(repository: UserPreferencesRepository) {
    val darkModeEnabled by repository.darkModeEnabled.collectAsState(initial = false)

    Switch(
        checked = darkModeEnabled,
        onCheckedChange = { enabled ->
            LaunchedEffect(enabled) {
                repository.setDarkModeEnabled(enabled)
            }
        },
        label = { Text("开启深色模式") }
    )
}

三、关于AndroidX Preference Library的补充 #

这个库确实默认绑定了自带的UI组件，若非要用它的持久化能力，可通过PreferenceDataStoreCompat与自定义Compose UI结合，但这种方式本质仍依赖已弃用的SharedPreferences生态，长远来看不如Proto DataStore符合官方演进方向。

内容的提问来源于stack exchange，提问作者O. R. Mapper