原生移动开发 / 系统课时

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 内部。

kotlin
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 项目中。

kotlin
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")
        }
    }
}

预期结果

text
页面初始显示 Count: 0。
每点击一次 Increment,ViewModel 更新 StateFlow,界面自动重组并显示递增后的数值。

StateFlow 到 Compose 的状态更新链路

保持单向数据流

如果把 MutableStateFlow 直接公开,Composable 或其他调用方都能随意赋值,状态来源会变得不可追踪。保持“内部可写、外部只读”后,用户事件先进入 ViewModel,ViewModel 计算新状态,再由 StateFlow 推送给 UI,形成清晰的单向数据流。

StateFlow 更适合表示“现在页面是什么样”,例如加载中、数据内容和错误提示。一次性动作不应通过一个会长期保留的状态值被重复消费;应根据应用架构把这类动作转换为明确的 UI 状态变化或单独的事件处理逻辑。

生命周期与重组边界

Compose 的重组可能频繁发生,因此不要在 Composable 函数体里重复创建 Flow 或启动独立的长期收集任务。让 ViewModel 持有稳定的 StateFlow,再由 collectAsStateWithLifecycle 负责订阅,可以把“状态生命周期”和“界面重组”解耦。

如果页面状态由多个 Flow 组合而来,可以在 ViewModel 中先使用 combine、map 等操作符得到统一的 UI 状态,再暴露给 Compose。这样界面层只负责渲染和发送用户意图,不承担业务状态拼装工作。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

StateFlow 与 Compose

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通