原生移动开发 / 系统课时
StateFlow 与 Compose
StateFlow 与 Compose
StateFlow 适合在 ViewModel 中保存“当前界面状态”,Compose 则根据状态自动重组 UI。本节把状态定义、ViewModel 更新和生命周期安全收集连成一条完整链路,避免手动订阅造成后台无意义收集。
学习目标
- 在 ViewModel 中使用
MutableStateFlow保存并更新 UI 状态。 - 只向界面暴露只读
StateFlow,避免外部直接修改状态。 - 在 Compose 中使用
collectAsStateWithLifecycle按生命周期安全收集。
在 ViewModel 中持有状态
StateFlow 始终保存一个当前值,新的收集者会先获得最新状态。常见写法是在 ViewModel 内部使用可变的 MutableStateFlow,对外只暴露只读 StateFlow。
下面是片段示例,依赖 Android ViewModel、Jetpack Compose,以及提供 collectAsStateWithLifecycle 的 Lifecycle Compose 集成库。它用不可变数据类描述页面状态,并把写权限限制在 ViewModel 内部。
import androidx.lifecycle.ViewModel
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.StateFlow
import kotlinx.coroutines.flow.asStateFlow
import kotlinx.coroutines.flow.update
data class CounterUiState(
val count: Int = 0
)
class CounterViewModel : ViewModel() {
private val _uiState = MutableStateFlow(CounterUiState())
val uiState: StateFlow<CounterUiState> = _uiState.asStateFlow()
fun increment() {
_uiState.update { current ->
current.copy(count = current.count + 1)
}
}
}update 会基于当前值计算新状态,适合不可变 data class。界面只能读取 uiState,所有修改都通过 ViewModel 的公开方法发生,因此状态来源更容易追踪和测试。
在 Compose 中安全收集
对于 Android Compose 界面,优先使用 collectAsStateWithLifecycle 把 StateFlow 转成 Compose 可观察的 State,并让收集行为跟随界面生命周期,而不是在 Composable 函数体中手动启动无限收集协程。
下面仍是片段示例,需要与前面的 CounterViewModel 放在同一 Android 项目中。
import androidx.compose.foundation.layout.Column
import androidx.compose.material3.Button
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.lifecycle.compose.collectAsStateWithLifecycle
@Composable
fun CounterScreen(
viewModel: CounterViewModel
) {
val uiState = viewModel.uiState.collectAsStateWithLifecycle()
Column {
Text(text = "Count: ${uiState.value.count}")
Button(onClick = viewModel::increment) {
Text("Increment")
}
}
}预期结果
页面初始显示 Count: 0。
每点击一次 Increment,ViewModel 更新 StateFlow,界面自动重组并显示递增后的数值。
保持单向数据流
如果把 MutableStateFlow 直接公开,Composable 或其他调用方都能随意赋值,状态来源会变得不可追踪。保持“内部可写、外部只读”后,用户事件先进入 ViewModel,ViewModel 计算新状态,再由 StateFlow 推送给 UI,形成清晰的单向数据流。
StateFlow 更适合表示“现在页面是什么样”,例如加载中、数据内容和错误提示。一次性动作不应通过一个会长期保留的状态值被重复消费;应根据应用架构把这类动作转换为明确的 UI 状态变化或单独的事件处理逻辑。
生命周期与重组边界
Compose 的重组可能频繁发生,因此不要在 Composable 函数体里重复创建 Flow 或启动独立的长期收集任务。让 ViewModel 持有稳定的 StateFlow,再由 collectAsStateWithLifecycle 负责订阅,可以把“状态生命周期”和“界面重组”解耦。
如果页面状态由多个 Flow 组合而来,可以在 ViewModel 中先使用 combine、map 等操作符得到统一的 UI 状态,再暴露给 Compose。这样界面层只负责渲染和发送用户意图,不承担业务状态拼装工作。