Android ViewModel 与状态管理
用途 本技能面向 Android 开发,提供实现 ViewModel 的最佳实践,核心目标是让 ViewModel 持有状态与业务逻辑,并确保其生命周期长于配置变更(如屏幕旋转)。
主要能力
- UI 状态(StateFlow)
- 用途:表示 UI 的持久状态,例如 Loading、Success(data)、Error。
- 类型:StateFlow<UiState>。
- 初始化:必须提供初始值。
- 暴露方式:对外暴露为只读的 StateFlow,内部由私有的 MutableStateFlow 支撑。示例: private val _uiState = MutableStateFlow<UiState>(UiState.Loading) val uiState: StateFlow<UiState> = _uiState.asStateFlow()
- 更新方式:使用 .update { oldState -> ... } 更新状态,以保证线程安全。
- 一次性事件(SharedFlow)
- 用途:处理瞬时事件,例如“显示 Toast”“导航到某屏幕”“显示 Snackbar”。
- 类型:SharedFlow<UiEvent>。
- 配置:必须使用 replay = 0,防止屏幕旋转时事件被重新触发。示例: private val _uiEvent = MutableSharedFlow<UiEvent>(replay = 0) val uiEvent: SharedFlow<UiEvent> = _uiEvent.asSharedFlow()
- 发送方式:使用 .emit(event)(挂起函数)或 .tryEmit(event)。
- 在 UI 中收集
- Compose:对 StateFlow 使用 collectAsStateWithLifecycle()。示例: val state by viewModel.uiState.collectAsStateWithLifecycle() 对 SharedFlow,使用 LaunchedEffect 配合 LocalLifecycleOwner。
- Views(XML):在协程中使用 repeatOnLifecycle(Lifecycle.State.STARTED)。
- 作用域
- ViewModel 启动的所有协程应使用 viewModelScope。
- 理想情况下,具体操作应委托给 UseCases 或 Repositories。
使用方式 按照上述规则在 Android 项目中定义 ViewModel:用 StateFlow 承载 UI 状态并暴露只读版本,用 SharedFlow(replay = 0)承载一次性事件,在 Compose 或 XML 视图中按对应方式收集,并在 viewModelScope 中启动协程。
适用场景 适用于需要跨配置变更保持 UI 状态、并需要区分持久状态与瞬时事件的 Android 应用开发,尤其是采用 Compose 或传统 XML 视图的项目。
限制 资料未提供关于具体依赖版本、完整示例工程、错误处理策略或与其他架构组件集成的更多细节,暂未提供。