读取和写入设置
保存并观察用户偏好设置
读取和写入设置 是 CoddyKit 上的免费 Android Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Android Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Android Academy 课程共包含 4 节课。
读取与写入
定义好键后，两个核心操作就是读取数据流，以及使用 edit 进行写入。读取具有响应性，写入是挂起函数。
数据 Flow
dataStore.data 是一个 Flow<Preferences>。每次写入时，该数据流都会发出新的 Preferences 快照，因此收集器会自动保持最新。
val rawData: Flow<Preferences> = dataStore.data映射单个值
您很少需要整个 Preferences 对象。请使用 map 提取一个键，并应用默认值。
val darkMode: Flow<Boolean> = dataStore.data
.map { prefs -> prefs[PrefKeys.DARK_MODE] ?: false }处理读取错误
从磁盘读取时可能会出现 IOException。请在 map 之前使用 catch 发出空偏好设置，并让数据流继续运行。
val darkMode: Flow<Boolean> = dataStore.data
.catch { e ->
if (e is IOException) emit(emptyPreferences())
else throw e
}
.map { it[PrefKeys.DARK_MODE] ?: false }使用 edit 写入
要更改值，请调用 edit 挂起函数。在 lambda 中，您会获得一个可变的偏好设置对象；请在其中设置键。整个代码块构成一个事务。
suspend fun setDarkMode(enabled: Boolean) {
dataStore.edit { prefs ->
prefs[PrefKeys.DARK_MODE] = enabled
}
}edit 是挂起函数
由于 edit 会挂起，您必须从协程中调用它，通常是在 ViewModel 中使用 viewModelScope.launch。这样可以确保写入操作在主线程之外执行。
fun toggleDarkMode(value: Boolean) {
viewModelScope.launch {
repository.setDarkMode(value)
}
}更新多个键
一个 edit 代码块可以设置多个键。它们会以原子方式一起提交，因此观察者永远不会看到部分更新。
dataStore.edit { prefs ->
prefs[PrefKeys.USERNAME] = "ada"
prefs[PrefKeys.DARK_MODE] = true
prefs[PrefKeys.FONT_SIZE] = 16
}递增值
在 edit 中，您可以读取当前值并计算新值，这对于启动次数等计数器非常方便。
suspend fun incrementLaunchCount() {
dataStore.edit { prefs ->
val current = prefs[PrefKeys.LAUNCH_COUNT] ?: 0
prefs[PrefKeys.LAUNCH_COUNT] = current + 1
}
}移除与清空
可以使用 remove 移除单个键，也可以使用 clear 清空存储区；两者都应在 edit 代码块中执行。
dataStore.edit { prefs ->
prefs.remove(PrefKeys.USERNAME)
}
dataStore.edit { prefs ->
prefs.clear()
}在 Compose 中收集
在可组合函数中，使用 collectAsStateWithLifecycle() 将 ViewModel 数据流转换为状态。设置发生变化时，界面会重新组合。
val darkMode by viewModel.darkMode.collectAsStateWithLifecycle(initial = false)
Switch(
checked = darkMode,
onCheckedChange = { viewModel.toggleDarkMode(it) }
)读取-修改-写入循环
将整个过程串起来：界面通过数据流读取，用户进行切换，ViewModel 启动协程并调用 edit，DataStore 执行写入，数据流重新发出值，界面重新组合。端到端实现完全响应式。
快速检查
请检验您对读取和写入的理解。
回顾
现在您已经可以读取和写入设置：
dataStore.data是响应式的Flow<Preferences>map提取单个值，catch处理输入输出错误dataStore.edit { }从协程中以原子方式执行写入collectAsStateWithLifecycle驱动 Compose 界面
接下来：使用 Proto DataStore 处理类型化的结构化数据。
常见问题解答
「读取和写入设置」课时是免费的吗？
是的 — 「读取和写入设置」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Android Academy 课程的其余内容，请升级到 CoddyKit PRO。 Android Academy 课程共包含 4 节课。
「读取和写入设置」这节课中我会学到什么？
保存并观察用户偏好设置 你通过在浏览器中直接运行的动手代码来练习 Android Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Android Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Android Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「读取和写入设置」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Android Academy 课中编写并运行代码吗？
能。每节 Android Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。