collectAsStateWithLifecycle
结合生命周期安全地收集数据流
collectAsStateWithLifecycle 是 CoddyKit 上的免费 Android Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Android Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Android Academy 课程共包含 4 节课。
安全地收集流
当可组合函数收集一个流时，理想情况下，屏幕处于后台期间应停止收集，返回前台后再恢复。
用于此目的的工具是 collectAsStateWithLifecycle()。
collectAsState 的问题
普通的 collectAsState() 只要可组合函数处于组合中就会持续收集，即使应用处于后台也是如此。
这可能会浪费资源，并处理用户无法看到的更新。
使用 collectAsStateWithLifecycle
这个具备生命周期感知能力的收集器会在生命周期降到目标状态以下时暂停收集（默认为 STARTED），并在生命周期恢复后继续收集。
import androidx.lifecycle.compose.collectAsStateWithLifecycle
@Composable
fun Screen(vm: MyViewModel) {
val state by vm.uiState
.collectAsStateWithLifecycle()
Text(state.title)
}依赖项
它位于 androidx.lifecycle:lifecycle-runtime-compose 构件中。请将其添加到您的模块中，以便导入成功解析。
// build.gradle (module)
implementation(
"androidx.lifecycle:lifecycle-runtime-compose:2.x.x"
)默认最低状态：STARTED
默认情况下，只要生命周期至少处于 STARTED 状态，收集就会处于活动状态，也就是说屏幕可见。当屏幕进入后台（低于 STARTED）时，收集会暂停。
自定义最低状态
您可以使用 minActiveState 更改阈值，例如改为 RESUMED。
val state by vm.uiState.collectAsStateWithLifecycle(
minActiveState = Lifecycle.State.RESUMED
)与 StateFlow 配合使用
它与您从 ViewModel 暴露的 StateFlow 配合得非常好。该流始终具有当前值，因此重新收集后会立即显示最新状态。
private val _uiState = MutableStateFlow(UiState())
val uiState = _uiState.asStateFlow()为何能减少工作量
如果您的流驱动着开销较大的计算（例如筛选大型列表、转换数据流），那么在后台暂停收集意味着用户离开期间不会执行这些工作。
与 viewModelScope 结合
在生产者一侧，ViewModel 通常会在 viewModelScope 中运行其数据处理流程。使用 stateIn 后，您甚至可以让上游在没有收集器时停止。
val uiState = repository.stream()
.stateIn(
scope = viewModelScope,
started = SharingStarted.WhileSubscribed(5000),
initialValue = UiState()
)WhileSubscribed 详解
WhileSubscribed(5000) 会在最后一个收集器离开后让上游继续存活 5 秒。这样可以避免在短暂的配置更改期间重新启动工作，同时在用户真正离开后仍能停止工作。
最佳实践总结
对于由 ViewModel 支持的 Compose 屏幕：
- 暴露一个
StateFlow。 - 使用
collectAsStateWithLifecycle()进行收集。 - 可以选择在上游使用
stateIn(WhileSubscribed)。
快速检查
请测试您对生命周期感知收集的理解。
回顾
您学到了：
collectAsStateWithLifecycle()会在后台暂停收集。- 默认阈值是 STARTED，可通过
minActiveState调整。 - 将它与
StateFlow和stateIn(WhileSubscribed)配合使用，可构建高效的数据处理流程。
常见问题解答
「collectAsStateWithLifecycle」课时是免费的吗？
是的 — 「collectAsStateWithLifecycle」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Android Academy 课程的其余内容，请升级到 CoddyKit PRO。 Android Academy 课程共包含 4 节课。
「collectAsStateWithLifecycle」这节课中我会学到什么？
结合生命周期安全地收集数据流 你通过在浏览器中直接运行的动手代码来练习 Android Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Android Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Android Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「collectAsStateWithLifecycle」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Android Academy 课中编写并运行代码吗？
能。每节 Android Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 为什么使用 ViewModel
- 从 ViewModel 暴露状态
- Android 生命周期
- collectAsStateWithLifecycle