目录
- 前言
- 一、先看一个"一切归零"的现场
- 二、选型:三种工具,三种职责
- [2.1 一张决策表](#2.1 一张决策表)
- 三、DataStore:偏好设置的"现代答案"
- [3.1 为什么不用 SharedPreferences](#3.1 为什么不用 SharedPreferences)
- [3.2 Preferences 还是 Proto](#3.2 Preferences 还是 Proto)
- [3.3 工程化写法:单实例 + Repository 收口](#3.3 工程化写法:单实例 + Repository 收口)
- [3.4 在 Compose 中消费](#3.4 在 Compose 中消费)
- 四、Room:结构化数据的"主战场"
- [4.1 Room 在 Compose 架构里的位置](#4.1 Room 在 Compose 架构里的位置)
- [4.2 KSP 而不是 KAPT](#4.2 KSP 而不是 KAPT)
- [4.3 DAO:三种异步模式](#4.3 DAO:三种异步模式)
- [4.4 在 Compose 中消费 Room 的 Flow](#4.4 在 Compose 中消费 Room 的 Flow)
- [4.5 Room 的边界](#4.5 Room 的边界)
- [五、文件存储:大文件与 Blob 的归宿](#五、文件存储:大文件与 Blob 的归宿)
- [5.1 什么时候用文件存储](#5.1 什么时候用文件存储)
- [5.2 安全读写:Dispatchers.IO 是底线](#5.2 安全读写:Dispatchers.IO 是底线)
- [5.3 文件存储不是响应式的](#5.3 文件存储不是响应式的)
- 六、综合实战:一个"关掉App也不丢"的搜索页面
- [6.1 搜索词:DataStore(或 SavedStateHandle)](#6.1 搜索词:DataStore(或 SavedStateHandle))
- [6.2 搜索结果:Room(SSOT)](#6.2 搜索结果:Room(SSOT))
- [6.3 搜索历史:DataStore](#6.3 搜索历史:DataStore)
- [6.4 在 Compose 里组合](#6.4 在 Compose 里组合)
- 七、常见陷阱速查
- 八、思维模型:持久化的"三层选型"
- 九、小结与下一课预告
前言
先聊一个几乎每个 Android 开发者都踩过的坑。
你花了一整天,把 App 的深色模式开关做得漂漂亮亮,用户点一下,界面立刻切换,丝滑得不行。你心满意足地关掉模拟器,第二天再打开------开关回到了浅色。用户一脸疑惑:"我昨天不是设置过了吗?"
或者更尴尬的场景:用户正在搜索框里输入一个长查询,切出去回了个微信,再切回来,输入框空了。用户以为是自己手滑,又输了一遍。
这些问题的根源,其实就一句话:数据只活在了内存里,进程一死,一切归零。
内存是"临时工",它只负责让数据在运行时跑得快、拿得顺手;而磁盘才是"档案室",它负责让数据在进程死亡、配置变更、设备重启之后,还能被原样找回来。所谓"持久化",就是把内存里的状态,稳稳当当地搬进磁盘这个档案室。
听起来简单,做起来却有不少门道。存错了地方,轻则性能拉胯、App 卡顿,重则数据损坏、迁移失败、多进程读写打架。Android 的持久化方案又特别多:SharedPreferences、DataStore、Room、文件存储、SQLite 裸写......新手很容易陷入"到底该用哪个"的选择困难。
所以这一课,我们不打算一上来就堆 API。我们想先帮你建立一个清晰的判断框架:什么数据该存哪里,为什么这么存,以及在 Compose 的响应式世界里,怎么把它安全地用起来。
具体来说,我们会沿着三条线由浅入深地走:
- 先看现场:从几个"一切归零"的真实故障出发,理解持久化到底要解决什么问题。
- 再做选型:把 DataStore、Room、文件存储这三种工具摆在一起,讲清楚它们各自的职责边界,给你一张能直接照着用的决策表。
- 最后落地:逐个拆解每种工具的工程化写法,再用一个"关掉 App 也不丢"的搜索页面,把三者组合起来跑通。
如果你之前一直靠 remember 或 SavedStateHandle 硬扛,或者对 SharedPreferences 又爱又恨,那这一课会帮你把这些零散的经验串成一条完整的线。不用怕概念多,我们会一步一步来,每个工具都配了能直接复制的代码。
准备好了吗?我们从一个"一切归零"的现场开始。
一、先看一个"一切归零"的现场
第43课我们把输入体验打磨到了"打字是享受"。用户在搜索框里输了一个长查询,键盘弹出来,组合区域正常,光标不跳。然后用户切到微信回了一条消息,再切回来------输入框是空的。
用户登录后,你把他的一些偏好设置(深色模式、字号、通知开关)存在了 remember 里。用户关掉App,第二天打开------所有设置恢复默认,深色模式变回了浅色。
用户离线时浏览了一批文章,你从网络加载后直接放在了 StateFlow 里。用户没网的时候再打开------一片空白,什么都没有。
这些问题的共同点是:数据只活在了内存里。 进程一死,一切归零。
持久化要解决的就是这件事:把"内存里的状态"变成"磁盘上的数据",让它在进程死亡、配置变更、甚至设备重启之后,依然能够恢复。 但持久化不是"随便存一下"那么简单。存错了地方,轻则性能拉胯,重则数据损坏、迁移失败、多进程读写打架。
这一课,我们就把 Compose 的持久化体系彻底讲清楚。核心不是背 API,而是搞清楚三个问题:存什么、存哪里、以及怎么在 Compose 的响应式世界里安全地用起来。
二、选型:三种工具,三种职责
Android 的持久化方案很多,但在 Compose 的现代架构里,真正需要日常打交道的只有三种:DataStore、Room、文件存储。它们不是互相替代的关系,而是各管一摊。
三种工具在 Compose 架构中的职责分工,可以用一张图直观地看清楚:
#mermaid-svg-ADPuZAtTer940plL{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-ADPuZAtTer940plL .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-ADPuZAtTer940plL .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-ADPuZAtTer940plL .error-icon{fill:#552222;}#mermaid-svg-ADPuZAtTer940plL .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-ADPuZAtTer940plL .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-ADPuZAtTer940plL .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-ADPuZAtTer940plL .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-ADPuZAtTer940plL .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-ADPuZAtTer940plL .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-ADPuZAtTer940plL .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-ADPuZAtTer940plL .marker{fill:#333333;stroke:#333333;}#mermaid-svg-ADPuZAtTer940plL .marker.cross{stroke:#333333;}#mermaid-svg-ADPuZAtTer940plL svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-ADPuZAtTer940plL p{margin:0;}#mermaid-svg-ADPuZAtTer940plL .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-ADPuZAtTer940plL .cluster-label text{fill:#333;}#mermaid-svg-ADPuZAtTer940plL .cluster-label span{color:#333;}#mermaid-svg-ADPuZAtTer940plL .cluster-label span p{background-color:transparent;}#mermaid-svg-ADPuZAtTer940plL .label text,#mermaid-svg-ADPuZAtTer940plL span{fill:#333;color:#333;}#mermaid-svg-ADPuZAtTer940plL .node rect,#mermaid-svg-ADPuZAtTer940plL .node circle,#mermaid-svg-ADPuZAtTer940plL .node ellipse,#mermaid-svg-ADPuZAtTer940plL .node polygon,#mermaid-svg-ADPuZAtTer940plL .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-ADPuZAtTer940plL .rough-node .label text,#mermaid-svg-ADPuZAtTer940plL .node .label text,#mermaid-svg-ADPuZAtTer940plL .image-shape .label,#mermaid-svg-ADPuZAtTer940plL .icon-shape .label{text-anchor:middle;}#mermaid-svg-ADPuZAtTer940plL .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-ADPuZAtTer940plL .rough-node .label,#mermaid-svg-ADPuZAtTer940plL .node .label,#mermaid-svg-ADPuZAtTer940plL .image-shape .label,#mermaid-svg-ADPuZAtTer940plL .icon-shape .label{text-align:center;}#mermaid-svg-ADPuZAtTer940plL .node.clickable{cursor:pointer;}#mermaid-svg-ADPuZAtTer940plL .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-ADPuZAtTer940plL .arrowheadPath{fill:#333333;}#mermaid-svg-ADPuZAtTer940plL .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-ADPuZAtTer940plL .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-ADPuZAtTer940plL .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-ADPuZAtTer940plL .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-ADPuZAtTer940plL .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-ADPuZAtTer940plL .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-ADPuZAtTer940plL .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-ADPuZAtTer940plL .cluster text{fill:#333;}#mermaid-svg-ADPuZAtTer940plL .cluster span{color:#333;}#mermaid-svg-ADPuZAtTer940plL div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-ADPuZAtTer940plL .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-ADPuZAtTer940plL rect.text{fill:none;stroke-width:0;}#mermaid-svg-ADPuZAtTer940plL .icon-shape,#mermaid-svg-ADPuZAtTer940plL .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-ADPuZAtTer940plL .icon-shape p,#mermaid-svg-ADPuZAtTer940plL .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-ADPuZAtTer940plL .icon-shape .label rect,#mermaid-svg-ADPuZAtTer940plL .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-ADPuZAtTer940plL .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-ADPuZAtTer940plL .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-ADPuZAtTer940plL :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} Compose UI 层
ViewModel / UiState
DataStore
小型键值偏好
Room
结构化数据 / SSOT
文件存储
大文件与 Blob
网络请求
Flow 数据流
2.1 一张决策表
| 工具 | 适合存什么 | 不适合存什么 | 是否响应式 |
|---|---|---|---|
| DataStore | 小型键值偏好、开关、简单配置、Token | 列表数据、关系数据、大对象 | 是(Flow) |
| Room | 结构化数据、列表、关系、需要查询/分页/索引的数据 | 单条偏好、大文件 Blob | 是(Flow) |
| 文件存储 | 图片、视频、JSON 导出文件、日志、缓存 Blob | 需要查询或频繁原子更新的结构化数据 | 否(需要自己桥接) |
一句话记忆 :偏好用 DataStore,列表用 Room,大文件用文件存储。
官方和社区的共识非常一致:DataStore 适合保存小型偏好和应用配置,并通过异步数据流提供一致读取;大量记录、复杂查询、关系和分页属于数据库问题,不应把整个业务模型塞进偏好文件 。如果一个查询用得上 WHERE 子句,那就应该用 Room,而不是 DataStore。
容量上的参考:小于 10KB 首选 DataStore;10KB 到 1MB 可以考虑 DataStore 或 Room;大于 1MB 推荐 Room 或文件存储。DataStore 每次编辑都会重写整个文件,所以不适合频繁写入大负载。
三、DataStore:偏好设置的"现代答案"
3.1 为什么不用 SharedPreferences
SharedPreferences 是同步 API,主线程读取可能阻塞;apply() 的异步落盘也没有清晰的一致性语义;多个模块直接操作同一份文件,类型约束和默认值会散落各处。
DataStore 的核心价值不只是"异步 API":
- Flow 持续暴露读取结果,天然适配 Compose 的响应式模型。
- 更新操作串行执行,适合表达原子读改写。
- 迁移、损坏处理和异常策略可以集中配置。
3.2 Preferences 还是 Proto
Preferences DataStore :键值模型,不需要 schema,适合从 SharedPreferences 平滑迁移。键是类型化的(booleanPreferencesKey、stringPreferencesKey 等),但仍然依赖字符串 key,重命名和类型变更需要自己维护。
Proto DataStore:使用 Protobuf 强类型 schema,更适合长期演进、字段会增删的场景。字段编号一旦使用就不要复用,删除字段时应保留编号,避免旧数据被新字段错误解释。
选择建议:从 SharedPreferences 迁移、字段少且稳定 → Preferences。配置结构需要明确版本演进、字段会变化 → Proto。
3.3 工程化写法:单实例 + Repository 收口
第一,保证单实例。 同一进程内,同一个文件只能有一个 DataStore 实例。不要在 Repository、Activity 或不同 DI 模块中重复调用 DataStoreFactory.create()。
用 Hilt 提供单例,作用域属于应用级存储组件,不应绑定 Activity 或 ViewModel:
kotlin
@Module
@InstallIn(SingletonComponent::class)
object StorageModule {
@Provides @Singleton
fun provideSettingsDataStore(
@ApplicationContext context: Context
): DataStore<Preferences> = PreferenceDataStoreFactory.create(
scope = CoroutineScope(SupervisorJob() + Dispatchers.IO),
produceFile = { context.dataStoreFile("user_settings.preferences_pb") }
)
}
第二,UI 层不应知道 key 名称,也不应直接调用 edit。 用 Repository 收口默认值、约束和错误策略:
kotlin
class SettingsRepository(
private val store: DataStore<Preferences>
) {
private val darkModeKey = booleanPreferencesKey("dark_mode")
val darkMode: Flow<Boolean> = store.data.map { prefs ->
prefs[darkModeKey] ?: false // 默认值是持久化契约的一部分
}
suspend fun setDarkMode(enabled: Boolean) {
store.edit { it[darkModeKey] = enabled } // 原子读改写
}
}
关键点 :edit { } 是事务性的原子读改写。不要在 UI 层"先读旧值、再基于旧值写入",那会产生竞态。多个并发操作时,使用明确的目标值比"取反当前值"更容易维持幂等。
3.4 在 Compose 中消费
kotlin
@Composable
fun SettingsScreen(
viewModel: SettingsViewModel = hiltViewModel()
) {
val darkMode by viewModel.darkMode.collectAsStateWithLifecycle()
Switch(
checked = darkMode,
onCheckedChange = { viewModel.setDarkMode(it) }
)
}
ViewModel 把 Repository 的冷 Flow 转成热 StateFlow:
kotlin
val darkMode: StateFlow<Boolean> = repository.darkMode
.stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), false)
collectAsStateWithLifecycle() 和 WhileSubscribed 的配合:应用进入后台时暂停收集,上游停止工作;回到前台时恢复。DataStore 的 Flow 本身是轻量的,但整条链路上的业务逻辑不应该在后台空转。
四、Room:结构化数据的"主战场"
4.1 Room 在 Compose 架构里的位置
Room 是 SQLite 之上的 ORM 层,负责把结构化、关系型、需要查询和分页 的数据持久化。在 MVVM/UDF 架构里,Room 通常担任单一事实来源(SSOT) :UI 永远读 Room 的 Flow,网络请求只负责把新数据写回 Room,数据流是单向的。
4.2 KSP 而不是 KAPT
Room 2.6 在 2026 年已经稳定,KSP 处理速度提升,Flow 集成也更好。新项目应该用 KSP,不要再使用 KAPT。
kotlin
plugins {
id("com.google.devtools.ksp")
}
dependencies {
implementation("androidx.room:room-runtime:2.6.1")
implementation("androidx.room:room-ktx:2.6.1") // 协程和Flow支持
ksp("androidx.room:room-compiler:2.6.1")
}
4.3 DAO:三种异步模式
Room 2.6 支持三种异步模式:
suspend函数:一次性操作(插入、更新、删除)。Flow返回值:响应式流(查询)。数据库任何变化,Flow 自动发射新值。ListenableFuture:Java 互操作,Compose 项目不需要。
kotlin
@Dao
interface ArticleDao {
@Query("SELECT * FROM articles ORDER BY publishedAt DESC")
fun observeArticles(): Flow<List<ArticleEntity>> // 响应式
@Insert(onConflict = OnConflictStrategy.REPLACE)
suspend fun upsertAll(articles: List<ArticleEntity>) // 一次性写
@Query("DELETE FROM articles WHERE id = :id")
suspend fun deleteById(id: Long)
}
4.4 在 Compose 中消费 Room 的 Flow
kotlin
@HiltViewModel
class ArticleListViewModel @Inject constructor(
private val dao: ArticleDao
) : ViewModel() {
val articles: StateFlow<List<Article>> = dao.observeArticles()
.map { entities -> entities.map { it.toDomain() } }
.stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), emptyList())
}
@Composable
fun ArticleListScreen(viewModel: ArticleListViewModel = hiltViewModel()) {
val articles by viewModel.articles.collectAsStateWithLifecycle()
LazyColumn {
items(articles, key = { it.id }) { article ->
ArticleRow(article)
}
}
}
核心链路 :Room 数据库变化 → Flow 发射 → ViewModel stateIn → collectAsStateWithLifecycle → Composable 重组。UI 永远不需要手动刷新,数据库一变,界面自动更新。
整条响应式链路可以概括为下面这张图:
#mermaid-svg-fUrm7eAeaGcf1OvU{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-fUrm7eAeaGcf1OvU .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-fUrm7eAeaGcf1OvU .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-fUrm7eAeaGcf1OvU .error-icon{fill:#552222;}#mermaid-svg-fUrm7eAeaGcf1OvU .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-fUrm7eAeaGcf1OvU .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-fUrm7eAeaGcf1OvU .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-fUrm7eAeaGcf1OvU .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-fUrm7eAeaGcf1OvU .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-fUrm7eAeaGcf1OvU .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-fUrm7eAeaGcf1OvU .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-fUrm7eAeaGcf1OvU .marker{fill:#333333;stroke:#333333;}#mermaid-svg-fUrm7eAeaGcf1OvU .marker.cross{stroke:#333333;}#mermaid-svg-fUrm7eAeaGcf1OvU svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-fUrm7eAeaGcf1OvU p{margin:0;}#mermaid-svg-fUrm7eAeaGcf1OvU .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-fUrm7eAeaGcf1OvU .cluster-label text{fill:#333;}#mermaid-svg-fUrm7eAeaGcf1OvU .cluster-label span{color:#333;}#mermaid-svg-fUrm7eAeaGcf1OvU .cluster-label span p{background-color:transparent;}#mermaid-svg-fUrm7eAeaGcf1OvU .label text,#mermaid-svg-fUrm7eAeaGcf1OvU span{fill:#333;color:#333;}#mermaid-svg-fUrm7eAeaGcf1OvU .node rect,#mermaid-svg-fUrm7eAeaGcf1OvU .node circle,#mermaid-svg-fUrm7eAeaGcf1OvU .node ellipse,#mermaid-svg-fUrm7eAeaGcf1OvU .node polygon,#mermaid-svg-fUrm7eAeaGcf1OvU .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-fUrm7eAeaGcf1OvU .rough-node .label text,#mermaid-svg-fUrm7eAeaGcf1OvU .node .label text,#mermaid-svg-fUrm7eAeaGcf1OvU .image-shape .label,#mermaid-svg-fUrm7eAeaGcf1OvU .icon-shape .label{text-anchor:middle;}#mermaid-svg-fUrm7eAeaGcf1OvU .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-fUrm7eAeaGcf1OvU .rough-node .label,#mermaid-svg-fUrm7eAeaGcf1OvU .node .label,#mermaid-svg-fUrm7eAeaGcf1OvU .image-shape .label,#mermaid-svg-fUrm7eAeaGcf1OvU .icon-shape .label{text-align:center;}#mermaid-svg-fUrm7eAeaGcf1OvU .node.clickable{cursor:pointer;}#mermaid-svg-fUrm7eAeaGcf1OvU .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-fUrm7eAeaGcf1OvU .arrowheadPath{fill:#333333;}#mermaid-svg-fUrm7eAeaGcf1OvU .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-fUrm7eAeaGcf1OvU .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-fUrm7eAeaGcf1OvU .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-fUrm7eAeaGcf1OvU .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-fUrm7eAeaGcf1OvU .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-fUrm7eAeaGcf1OvU .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-fUrm7eAeaGcf1OvU .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-fUrm7eAeaGcf1OvU .cluster text{fill:#333;}#mermaid-svg-fUrm7eAeaGcf1OvU .cluster span{color:#333;}#mermaid-svg-fUrm7eAeaGcf1OvU div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-fUrm7eAeaGcf1OvU .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-fUrm7eAeaGcf1OvU rect.text{fill:none;stroke-width:0;}#mermaid-svg-fUrm7eAeaGcf1OvU .icon-shape,#mermaid-svg-fUrm7eAeaGcf1OvU .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-fUrm7eAeaGcf1OvU .icon-shape p,#mermaid-svg-fUrm7eAeaGcf1OvU .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-fUrm7eAeaGcf1OvU .icon-shape .label rect,#mermaid-svg-fUrm7eAeaGcf1OvU .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-fUrm7eAeaGcf1OvU .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-fUrm7eAeaGcf1OvU .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-fUrm7eAeaGcf1OvU :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} Room 数据库变化
DAO 返回 Flow 发射新值
ViewModel stateIn 转 StateFlow
collectAsStateWithLifecycle
Composable 重组
4.5 Room 的边界
Room 适合关系型数据,但不要用它存单条偏好开关 。一个开关的读取和写入,用 Room 是杀鸡用牛刀。同样,不要把大 Blob(图片、视频)直接塞进 Room 的列里------虽然技术上可行,但 SQLite 对大字段的读写并不高效,文件存储是更合适的选择。
五、文件存储:大文件与 Blob 的归宿
5.1 什么时候用文件存储
图片、视频、导出的 JSON 文件、日志、缓存 Blob------这些不需要查询、不适合放在数据库里的数据,用文件存储。
Android 提供了 context.filesDir(内部存储,应用私有)和 context.cacheDir(缓存,系统可能清理)。DataStore 自己也是把文件放在 filesDir/datastore/ 子目录下的。
5.2 安全读写:Dispatchers.IO 是底线
文件 I/O 绝对不能在主线程做。 Dispatchers.IO 就是为磁盘和网络 I/O 优化的调度器。在 Repository 层用 withContext(Dispatchers.IO) 包裹文件操作:
kotlin
class FileRepository(
private val context: Context
) {
suspend fun writeExport(fileName: String, content: String) =
withContext(Dispatchers.IO) {
val file = File(context.filesDir, fileName)
file.writeText(content)
}
suspend fun readExport(fileName: String): String =
withContext(Dispatchers.IO) {
val file = File(context.filesDir, fileName)
file.readText()
}
}
ViewModel 里不需要再切 Dispatcher :如果 Repository 的 suspend 函数内部已经用 withContext(Dispatchers.IO) 包裹,调用方直接用 viewModelScope.launch { } 即可,不需要再指定 dispatcher。
5.3 文件存储不是响应式的
DataStore 和 Room 都暴露 Flow,文件存储没有。如果你希望"文件变化时 UI 自动刷新",需要自己桥接:用 snapshotFlow、或者写入后手动发射一个新的状态。大多数文件存储场景是"一次性读/写"------比如导出文件、下载图片------不需要响应式。如果需要响应式,考虑把文件元数据(路径、更新时间)存在 Room 或 DataStore 里,文件本身用文件存储。
六、综合实战:一个"关掉App也不丢"的搜索页面
需求:用户输入搜索词,点击搜索后加载结果。搜索词需要跨进程死亡保留;搜索结果缓存在 Room 里,离线也能看;搜索历史存在 DataStore 里。
6.1 搜索词:DataStore(或 SavedStateHandle)
如果搜索词是页面级最小输入 ,第36课讲过 SavedStateHandle 就能扛住进程死亡。但如果搜索词需要跨会话保留(下次打开App还在),用 DataStore:
kotlin
class SearchPreferences @Inject constructor(
private val store: DataStore<Preferences>
) {
private val lastQueryKey = stringPreferencesKey("last_query")
val lastQuery: Flow<String> = store.data.map {
it[lastQueryKey] ?: ""
}
suspend fun saveQuery(query: String) {
store.edit { it[lastQueryKey] = query }
}
}
6.2 搜索结果:Room(SSOT)
kotlin
@Entity(tableName = "search_results")
data class SearchResultEntity(
@PrimaryKey val id: Long,
val title: String,
val snippet: String,
val query: String
)
@Dao
interface SearchResultDao {
@Query("SELECT * FROM search_results WHERE query = :query ORDER BY id")
fun observeResults(query: String): Flow<List<SearchResultEntity>>
@Insert(onConflict = OnConflictStrategy.REPLACE)
suspend fun insertAll(results: List<SearchResultEntity>)
@Query("DELETE FROM search_results WHERE query = :query")
suspend fun clear(query: String)
}
搜索时:网络结果 → 写入 Room → UI 从 Room 的 Flow 读取。离线时,Room 里还有上一次的结果,UI 不会白屏。
6.3 搜索历史:DataStore
kotlin
class SearchHistoryRepository(
private val store: DataStore<Preferences>
) {
private val historyKey = stringSetPreferencesKey("search_history")
val history: Flow<Set<String>> = store.data.map {
it[historyKey] ?: emptySet()
}
suspend fun add(query: String) {
store.edit { prefs ->
val current = prefs[historyKey] ?: emptySet()
prefs[historyKey] = (current + query).take(20).toSet()
}
}
}
6.4 在 Compose 里组合
kotlin
@Composable
fun SearchScreen(viewModel: SearchViewModel = hiltViewModel()) {
val results by viewModel.results.collectAsStateWithLifecycle()
val history by viewModel.history.collectAsStateWithLifecycle()
val lastQuery by viewModel.lastQuery.collectAsStateWithLifecycle()
// 全部是Flow → StateFlow → collectAsStateWithLifecycle
// UI只负责渲染,不需要关心数据从DataStore还是Room来
}
设计要点 :UI 层完全不知道 数据来自 DataStore 还是 Room。ViewModel 组合多个 Repository 的 Flow,暴露一个统一的 UiState。这就是第35课 UDF 闭环和持久化的自然结合。
整个搜索页面的数据流向如下:
#mermaid-svg-9WiXAeDJtnKsGOOk{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-9WiXAeDJtnKsGOOk .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-9WiXAeDJtnKsGOOk .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-9WiXAeDJtnKsGOOk .error-icon{fill:#552222;}#mermaid-svg-9WiXAeDJtnKsGOOk .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-9WiXAeDJtnKsGOOk .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-9WiXAeDJtnKsGOOk .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-9WiXAeDJtnKsGOOk .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-9WiXAeDJtnKsGOOk .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-9WiXAeDJtnKsGOOk .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-9WiXAeDJtnKsGOOk .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-9WiXAeDJtnKsGOOk .marker{fill:#333333;stroke:#333333;}#mermaid-svg-9WiXAeDJtnKsGOOk .marker.cross{stroke:#333333;}#mermaid-svg-9WiXAeDJtnKsGOOk svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-9WiXAeDJtnKsGOOk p{margin:0;}#mermaid-svg-9WiXAeDJtnKsGOOk .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-9WiXAeDJtnKsGOOk .cluster-label text{fill:#333;}#mermaid-svg-9WiXAeDJtnKsGOOk .cluster-label span{color:#333;}#mermaid-svg-9WiXAeDJtnKsGOOk .cluster-label span p{background-color:transparent;}#mermaid-svg-9WiXAeDJtnKsGOOk .label text,#mermaid-svg-9WiXAeDJtnKsGOOk span{fill:#333;color:#333;}#mermaid-svg-9WiXAeDJtnKsGOOk .node rect,#mermaid-svg-9WiXAeDJtnKsGOOk .node circle,#mermaid-svg-9WiXAeDJtnKsGOOk .node ellipse,#mermaid-svg-9WiXAeDJtnKsGOOk .node polygon,#mermaid-svg-9WiXAeDJtnKsGOOk .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-9WiXAeDJtnKsGOOk .rough-node .label text,#mermaid-svg-9WiXAeDJtnKsGOOk .node .label text,#mermaid-svg-9WiXAeDJtnKsGOOk .image-shape .label,#mermaid-svg-9WiXAeDJtnKsGOOk .icon-shape .label{text-anchor:middle;}#mermaid-svg-9WiXAeDJtnKsGOOk .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-9WiXAeDJtnKsGOOk .rough-node .label,#mermaid-svg-9WiXAeDJtnKsGOOk .node .label,#mermaid-svg-9WiXAeDJtnKsGOOk .image-shape .label,#mermaid-svg-9WiXAeDJtnKsGOOk .icon-shape .label{text-align:center;}#mermaid-svg-9WiXAeDJtnKsGOOk .node.clickable{cursor:pointer;}#mermaid-svg-9WiXAeDJtnKsGOOk .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-9WiXAeDJtnKsGOOk .arrowheadPath{fill:#333333;}#mermaid-svg-9WiXAeDJtnKsGOOk .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-9WiXAeDJtnKsGOOk .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-9WiXAeDJtnKsGOOk .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-9WiXAeDJtnKsGOOk .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-9WiXAeDJtnKsGOOk .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-9WiXAeDJtnKsGOOk .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-9WiXAeDJtnKsGOOk .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-9WiXAeDJtnKsGOOk .cluster text{fill:#333;}#mermaid-svg-9WiXAeDJtnKsGOOk .cluster span{color:#333;}#mermaid-svg-9WiXAeDJtnKsGOOk div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-9WiXAeDJtnKsGOOk .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-9WiXAeDJtnKsGOOk rect.text{fill:none;stroke-width:0;}#mermaid-svg-9WiXAeDJtnKsGOOk .icon-shape,#mermaid-svg-9WiXAeDJtnKsGOOk .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-9WiXAeDJtnKsGOOk .icon-shape p,#mermaid-svg-9WiXAeDJtnKsGOOk .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-9WiXAeDJtnKsGOOk .icon-shape .label rect,#mermaid-svg-9WiXAeDJtnKsGOOk .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-9WiXAeDJtnKsGOOk .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-9WiXAeDJtnKsGOOk .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-9WiXAeDJtnKsGOOk :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 用户输入搜索词
SearchPreferences
DataStore 保存搜索词
发起网络搜索
写入 Room 搜索结果表
UI 从 Room Flow 读取结果
SearchHistoryRepository
DataStore 保存历史
ViewModel 组合多个 Flow
暴露统一 UiState
七、常见陷阱速查
| 陷阱 | 真实场景 | 后果 | 解法 |
|---|---|---|---|
| 把列表塞进 DataStore | 用 stringSetPreferencesKey 存搜索结果 |
每次编辑重写整个文件,性能差 | 列表用 Room |
| 多实例 DataStore | 每个 Repository 都 preferencesDataStore |
并发写冲突、数据损坏 | 单例 + Hilt 提供 |
| 主线程读文件 | File.readText() 直接调用 |
ANR | withContext(Dispatchers.IO) |
UI 层直接调 store.edit |
Composable 里操作 DataStore | key 散落,无法测试 | Repository 收口 |
| 先读旧值再写新值 | val old = store.data.first(); store.edit { ... old ... } |
并发更新丢失 | 在同一个 edit { } 里原子读改写 |
collectAsState 裸收集 |
后台仍在监听 Room/DataStore | 资源浪费 | collectAsStateWithLifecycle + WhileSubscribed |
| 用 KAPT 编译 Room | 构建速度慢 | 开发体验差 | 迁移到 KSP |
| DataStore 存敏感 Token | 明文存在 filesDir |
安全风险 | 用加密的 DataStore 或 Keystore 包装 |
| 文件存储期待响应式 | 文件写了但 UI 不刷新 | 用户看不到更新 | 手动发射状态,或把元数据存 Room |
八、思维模型:持久化的"三层选型"
第一层:按数据形态选工具。 键值偏好 → DataStore。结构化/关系/可查询 → Room。大文件/Blob → 文件存储。不要让一种工具干所有事。
第二层:Repository 收口。 UI 和 ViewModel 不应该知道 DataStore 的 key、Room 的 SQL、文件路径。Repository 暴露业务语义的 Flow 和 suspend 函数,内部处理默认值、迁移、错误映射。
第三层:在 Compose 里用生命周期感知的方式消费。 DataStore 和 Room 都暴露 Flow,用 stateIn + SharingStarted.WhileSubscribed + collectAsStateWithLifecycle 消费。文件存储是命令式的,需要自己桥接。
贯穿始终的原则:持久化不是"存一下",而是"设计一个可靠的数据管道"。 DataStore 的原子更新、Room 的 SSOT、文件存储的 Dispatchers.IO------每个工具都有自己的契约,遵守契约,数据才不会丢、不会坏、不会拖垮 UI。
把三层选型模型画成一张图,方便随时对照:
#mermaid-svg-eq75BJ59ZJV9KIn2{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-eq75BJ59ZJV9KIn2 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-eq75BJ59ZJV9KIn2 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-eq75BJ59ZJV9KIn2 .error-icon{fill:#552222;}#mermaid-svg-eq75BJ59ZJV9KIn2 .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-eq75BJ59ZJV9KIn2 .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-eq75BJ59ZJV9KIn2 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-eq75BJ59ZJV9KIn2 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-eq75BJ59ZJV9KIn2 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-eq75BJ59ZJV9KIn2 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-eq75BJ59ZJV9KIn2 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-eq75BJ59ZJV9KIn2 .marker{fill:#333333;stroke:#333333;}#mermaid-svg-eq75BJ59ZJV9KIn2 .marker.cross{stroke:#333333;}#mermaid-svg-eq75BJ59ZJV9KIn2 svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-eq75BJ59ZJV9KIn2 p{margin:0;}#mermaid-svg-eq75BJ59ZJV9KIn2 .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-eq75BJ59ZJV9KIn2 .cluster-label text{fill:#333;}#mermaid-svg-eq75BJ59ZJV9KIn2 .cluster-label span{color:#333;}#mermaid-svg-eq75BJ59ZJV9KIn2 .cluster-label span p{background-color:transparent;}#mermaid-svg-eq75BJ59ZJV9KIn2 .label text,#mermaid-svg-eq75BJ59ZJV9KIn2 span{fill:#333;color:#333;}#mermaid-svg-eq75BJ59ZJV9KIn2 .node rect,#mermaid-svg-eq75BJ59ZJV9KIn2 .node circle,#mermaid-svg-eq75BJ59ZJV9KIn2 .node ellipse,#mermaid-svg-eq75BJ59ZJV9KIn2 .node polygon,#mermaid-svg-eq75BJ59ZJV9KIn2 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-eq75BJ59ZJV9KIn2 .rough-node .label text,#mermaid-svg-eq75BJ59ZJV9KIn2 .node .label text,#mermaid-svg-eq75BJ59ZJV9KIn2 .image-shape .label,#mermaid-svg-eq75BJ59ZJV9KIn2 .icon-shape .label{text-anchor:middle;}#mermaid-svg-eq75BJ59ZJV9KIn2 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-eq75BJ59ZJV9KIn2 .rough-node .label,#mermaid-svg-eq75BJ59ZJV9KIn2 .node .label,#mermaid-svg-eq75BJ59ZJV9KIn2 .image-shape .label,#mermaid-svg-eq75BJ59ZJV9KIn2 .icon-shape .label{text-align:center;}#mermaid-svg-eq75BJ59ZJV9KIn2 .node.clickable{cursor:pointer;}#mermaid-svg-eq75BJ59ZJV9KIn2 .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-eq75BJ59ZJV9KIn2 .arrowheadPath{fill:#333333;}#mermaid-svg-eq75BJ59ZJV9KIn2 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-eq75BJ59ZJV9KIn2 .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-eq75BJ59ZJV9KIn2 .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-eq75BJ59ZJV9KIn2 .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-eq75BJ59ZJV9KIn2 .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-eq75BJ59ZJV9KIn2 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-eq75BJ59ZJV9KIn2 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-eq75BJ59ZJV9KIn2 .cluster text{fill:#333;}#mermaid-svg-eq75BJ59ZJV9KIn2 .cluster span{color:#333;}#mermaid-svg-eq75BJ59ZJV9KIn2 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-eq75BJ59ZJV9KIn2 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-eq75BJ59ZJV9KIn2 rect.text{fill:none;stroke-width:0;}#mermaid-svg-eq75BJ59ZJV9KIn2 .icon-shape,#mermaid-svg-eq75BJ59ZJV9KIn2 .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-eq75BJ59ZJV9KIn2 .icon-shape p,#mermaid-svg-eq75BJ59ZJV9KIn2 .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-eq75BJ59ZJV9KIn2 .icon-shape .label rect,#mermaid-svg-eq75BJ59ZJV9KIn2 .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-eq75BJ59ZJV9KIn2 .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-eq75BJ59ZJV9KIn2 .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-eq75BJ59ZJV9KIn2 :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 第一层:按数据形态选工具
键值偏好 → DataStore
结构化/关系/可查询 → Room
大文件/Blob → 文件存储
第二层:Repository 收口
暴露业务语义 Flow 与 suspend 函数
第三层:生命周期感知消费
stateIn + WhileSubscribed + collectAsStateWithLifecycle
九、小结与下一课预告
这一课我们把持久化从"关掉App就归零"讲到了"可靠的数据管道"。关键点回顾:
- 选型:偏好用 DataStore,结构化用 Room,大文件用文件存储。不要用 DataStore 存列表,不要用 Room 存单条开关。
- DataStore :单实例 + Repository 收口 + 原子
edit。Preferences 适合迁移,Proto 适合 schema 演进。默认值是持久化契约。 - Room :KSP 编译,DAO 用
Flow做响应式查询,suspend做一次性写。Room 是 SSOT,网络数据写回 Room,UI 从 Room 读。 - 文件存储 :
Dispatchers.IO是底线。不是响应式的,需要自己桥接。 - Compose 消费 :
collectAsStateWithLifecycle+WhileSubscribed,生命周期感知,后台不空转。 - 常见陷阱 :DataStore 存列表、多实例、主线程 I/O、UI 直接
edit、先读后写竞态、裸collectAsState、KAPT、明文存 Token。
持久化是"状态"的地基。 第35课的 UDF 闭环让状态在内存里有序流动,持久化让状态在进程死亡后依然能重建。两者结合,你的 App 才真正"记得住"用户。
下一课,我们会讲Compose 中的网络请求与离线优先架构 。Room 是 SSOT,网络数据怎么同步进去?离线时 UI 怎么展示缓存?WorkManager 怎么做后台同步?网络状态变化怎么驱动 UI?Retrofit / Ktor 的响应怎么映射成领域模型?这是把"本地数据"和"远程数据"缝合起来的关键一课。
课后练习建议:找一个你之前用 remember 或 SavedStateHandle 存偏好的页面,把偏好迁移到 DataStore。然后找一段你直接从网络加载列表、没有本地缓存的逻辑,加上 Room 作为 SSOT:网络结果写 Room,UI 从 Room 的 Flow 读。最后,用 collectAsStateWithLifecycle 替换掉所有裸 collectAsState。做完之后,把 App 切到后台杀掉进程再打开,看看偏好和列表数据还在不在。