Jetpack Compose应用关闭后如何保留主题设置等数据？

rememberSaveable仅能应对屏幕旋转这类配置变更场景保留状态，不会将数据写入磁盘，所以重启应用后设置会丢失。要实现真正的持久化，推荐使用Jetpack DataStore的Preferences版本——专门用来存储这类轻量键值对配置。

步骤1：添加DataStore依赖 #

在Module级别的build.gradle.kts（或build.gradle）中添加依赖：

dependencies {
    // DataStore Preferences
    implementation("androidx.datastore:datastore-preferences:1.0.0")
}

步骤2：创建DataStore实例 #

定义一个单例的DataStore对象，用于统一管理配置存储：

import androidx.datastore.core.DataStore
import androidx.datastore.preferences.core.Preferences
import androidx.datastore.preferences.core.booleanPreferencesKey
import androidx.datastore.preferences.core.edit
import androidx.datastore.preferences.preferencesDataStore
import kotlinx.coroutines.flow.Flow
import kotlinx.coroutines.flow.map

// 扩展属性创建DataStore实例
val Context.dataStore: DataStore<Preferences> by preferencesDataStore(name = "app_settings")

// 定义存储键
private val DARK_THEME_KEY = booleanPreferencesKey("dark_theme")

// 封装读写方法
class SettingsRepository(private val dataStore: DataStore<Preferences>) {
    // 读取主题设置的Flow
    val darkThemeFlow: Flow<Boolean> = dataStore.data
        .map { preferences ->
            preferences[DARK_THEME_KEY] ?: false // 默认浅色主题
        }

    // 保存主题设置
    suspend fun saveDarkTheme(isDark: Boolean) {
        dataStore.edit { preferences ->
            preferences[DARK_THEME_KEY] = isDark
        }
    }
}

步骤3：在Compose中使用 #

将原来的remember替换为DataStore的Flow状态，同时处理保存逻辑：

@Composable
fun ThemeToggle() {
    val context = LocalContext.current
    val settingsRepo = remember { SettingsRepository(context.dataStore) }
    // 将Flow转换为Compose状态
    val darkTheme by settingsRepo.darkThemeFlow.collectAsStateWithLifecycle()

    Checkbox(
        checked = darkTheme,
        onCheckedChange = { newState ->
            // 启动协程保存设置
            LaunchedEffect(newState) {
                settingsRepo.saveDarkTheme(newState)
            }
        }
    )
}

额外建议 #

• 推荐将DataStore的逻辑放到ViewModel中，避免在Composable中直接处理协程和数据操作，让UI更简洁：

class SettingsViewModel(private val repo: SettingsRepository) : ViewModel() {
    val darkTheme = repo.darkThemeFlow.stateIn(
        scope = viewModelScope,
        started = SharingStarted.WhileSubscribed(5000),
        initialValue = false
    )

    fun toggleDarkTheme(isDark: Boolean) {
        viewModelScope.launch {
            repo.saveDarkTheme(isDark)
        }
    }
}

然后在Compose中使用ViewModel：

@Composable
fun ThemeToggle(viewModel: SettingsViewModel = viewModel()) {
    val darkTheme by viewModel.darkTheme.collectAsState()

    Checkbox(
        checked = darkTheme,
        onCheckedChange = viewModel::toggleDarkTheme
    )
}

这样修改后，主题设置会持久化到本地磁盘，重启应用后也能保留用户的选择。

内容的提问来源于stack exchange，提问作者0324bence