一、三件套的接口只有一个文件、15 行
整个 MVI 协议的定义,浓缩在一个 MVI.kt 里:
interface MVI<State : MVI.ViewState, Intent : MVI.ViewIntent, Event : MVI.ViewEvent> { interface ViewState // Screen 渲染所需的全部状态 interface ViewIntent // 用户/系统主动发起的动作 interface ViewEvent // ViewModel → UI 的一次性事件 fun updateState(update: (State) -> State) fun sendEvent(event: Event) fun handleIntent(intent: Intent) }
注意三个空接口不是摆设,它们是 类型系统的分界线 : - ViewState :可以被重复读取、幂等,丢了能重放; - ViewIntent :外部 → ViewModel 的单向入口,唯一被允许的“改变状态”的途径; - ViewEvent :一次性信号,收不到就该消失, 绝不重放 。 没有 Reducer、没有中间件、没有 SideEffect 五兄弟。车机项目的答案是: 先保证编译器和类型系统能约束住人,再谈模式优雅 。
二、容器实现:StateFlow 管“状态”,Channel 管“事件”
abstract class BaseMVIViewModel<State, Intent, Event>( initialState: State, ) : BaseViewModel(), MVI<State, Intent, Event> { private val _state = MutableStateFlow(initialState) val state: StateFlow get() = _state.asStateFlow() private val _event = Channel(capacity = Channel.CONFLATED) val event = _event.receiveAsFlow() override fun updateState(update: (State) -> State) { _state.update { update(it) } } fun sendIntent(intent: Intent) { handleIntent(intent) } }
这里有一个面试高频、实战更高频的决策: 为什么事件用 Channel 而不是 SharedFlow ? 车机 UI 的重建频率远超手机——分屏 resize、多屏切换、日夜主题切换都会触发重组甚至重订阅。如果事件流是 MutableSharedFlow(replay = 0) ,看似没有重放问题;但 SharedFlow 的 emit 与订阅之间存在竞态窗口: 订阅尚未完成时发出的事件会直接丢失 。而导航场景里“开始引导”“到达目的地”这种事件丢了就是事故。 Channel(CONFLATED) 的语义恰好匹配: 1. 元素只能被消费一次——重建不会弹两次 Toast; 2. CONFLATED 容量保证新订阅者立刻拿到“最近一个”事件——不丢关键信号; 3. trySend 永不挂起——ViewModel 侧发送零成本。 一个细节: state 用 get() = _state.asStateFlow() 而不是 by 委托初始化,配合子类大量使用 by lazy { ... } 暴露子状态流(后面会讲为什么)。
三、Intent 不是 enum,是 sealed class 带参数
看真实的引导页 Intent 定义:
@Stable sealed class ActiveGuidanceIntent : MVI.ViewIntent { data object OnDismissNearYourDestination : ActiveGuidanceIntent() data class OnNearYourDestinationItemClick( val searchCategory: SearchCategoryType, val searchCenter: GeoPoint? = null, val searchRadius: Distance? = null, ) : ActiveGuidanceIntent() data object ShowTbt : ActiveGuidanceIntent() data object SwitchTbtSpeechState : ActiveGuidanceIntent() data class SetKeyboardVisibility(val isVisible: Boolean) : ActiveGuidanceIntent() }
三个工程细节:
1. data object 而不是 object ——无参 Intent 用 data object 生成有意义的 toString() 。这不是炫技: handleIntent 的第一行是日志
override fun handleIntent(intent: ActiveGuidanceIntent) { Logger.d(TAG) { "handleIntent: $intent" }
车机问题排查靠 logcat 回放, OnNearYourDestinationItemClick(searchCategory=CHARGING, ...) 这种日志能直接定位用户操作序列。
2. 参数用业务类型而非原始类型 —— searchRadius: Distance? 而不是 Int? 。Intent 是跨层的输入契约,把“米”还是“公里”的歧义堵在编译期。
3. @Stable 注解 ——告诉 Compose 编译器这类是不可变类型,跳过不必要的重组比较。
handleIntent 的分发就是标准的 when 穷尽匹配——sealed class 的最大红利: 新增一个 Intent 而忘记处理时,编译直接报错 ,不需要 lint 也不需要 code review 兜底。
四、Event 竟然是空的——这是故意的
再看引导页的 Event 定义:
@Immutable sealed class ActiveGuidanceEvent : MVI.ViewEvent @Stable class ActiveGuidanceState : MVI.ViewState
Event 是一个 空的 sealed class 。这不是偷懒,而是一次显式的架构表态: 当团队把大量“事件”塞进 Event 通道时(Toast、导航跳转、弹窗、刷新……),事件流会迅速失控——事件可能在任何时机到达,UI 处理顺序不可控。这个项目的原则是: 能用状态表达的就绝不用事件 。 看它如何处理“到达目的地推荐”这个场景——不是发一个 ShowRecommendation 事件,而是把多个状态流 combine:
private val isRecommendationDismissed = MutableStateFlow(false) private val isKeyboardVisible = MutableStateFlow(false) viewModelScope.launch { observeRecommendationUiState( isDismissedFlow = isRecommendationDismissed, isKeyboardVisibleFlow = isKeyboardVisible, ).collect { if (it is RecommendationUiState.Visible && guidanceRepo.isGuidanceActive) { bannerManager.show(Banner.NearDestination(it.model)) } else { bannerManager.hide<Banner.NearDestination>() } } }
“推荐横幅是否显示”是 状态的函数 :推荐数据可用 ∧ 未被用户关闭 ∧ 键盘未弹出 ∧ 引导中。四个条件任何时刻变化,结果自动重算——屏幕重建后直接拿到正确答案,不存在“事件没赶上”的问题。 Event 通道留给真正的“一次性副作用”:播放一条语音、震动一次。 当你的 Event sealed class 长期是空的,说明状态建模做对了。
五、UI 侧的对接:一条函数引用就够
Screen 层的对接代码干净到近乎无聊
@Composable fun GuidanceScreen(vm: GuidanceViewModel, ...) { val state by vm.state.collectAsStateWithLifecycle() ... GuidanceContent( state = state, sendIntent = vm::handleIntent, ... ) }
要点: - 状态收集统一 collectAsStateWithLifecycle ——后台时停止收集,车机的地图渲染极耗资源,不能让不可见的屏幕白烧 CPU; - sendIntent = vm::handleIntent 传函数引用而非 lambda 包装,UI 组件不知道 ViewModel 的存在,只认识 (Intent) -> Unit ——这使 GuidanceContent 可以脱离 ViewModel 直接做 Compose 预览和截图测试。 在最大的组合入口 MainContent 里,全项目收集最密集的 19 处 collectAsStateWithLifecycle 同时工作:地图状态、TBT 状态、限速摄像、危险品提示、ETA 卡片、反馈进度……每个都是独立的细粒度 StateFlow, 一个状态变化只重组订阅它的那一小块 UI 。
六、单一 StateFlow 之外:子状态流按“变化频率”拆分
GuidanceViewModel 并没有把所有状态塞进 ActiveGuidanceState 一个类,而是按 变化频率 分层暴露:
// 高频:每秒更新(路线进度),独立流 val routeProgressFlow = ... // 中频:每个转向更新(TBT 大图) val tbtUiState: StateFlow by lazy { tbtStateManager.tbtUiState } // 低频:用户操作才变 private val _hazardUiState by lazy { MutableStateFlow(HazardUiState()) } val hazardUiState: StateFlow by lazy { _hazardUiState.asStateFlow() }
原因是车机硬件现实:路线进度每秒刷新,如果它和其他状态共用一个 StateFlow, 每一秒都引发整个引导屏的重组 ——包括本不需要刷新的 TBT 大图、危险品卡片。拆流之后,Compose 智能跳过未变化的组件。 而 by lazy 也不是习惯性写法——部分子状态流的初始化依赖注入完成后的字段,lazy 保证首次访问时才构造,避免构造函数里的初始化顺序陷阱。
七、生命周期收集:不用 repeatOnLifecycle 的理由
前面提到基类有自建的收集机制:
override fun screenComposed() { scope?.cancel() scope = CoroutineScope(SupervisorJob() + Dispatchers.Main.immediate) startRepeatableActions() onScreenComposed() } protected fun repeatWhenStarted(action: suspend CoroutineScope.() -> Unit) { repeatableActions += action if (scope?.isActive == true) { scope!!.launch { action() } } }
为什么不直接用 repeatOnLifecycle(Lifecycle.State.STARTED) ?因为这个 App 是 进程常驻的 Launcher 应用 :屏幕的生命周期由导航栈的 compose/dispose 驱动,与 Activity 生命周期完全不同步。车机上“主屏退到后台但进程存活”是常态,收集必须绑定到 屏幕可见性 而非 Activity 状态。 repeatWhenStarted 就是绑定屏幕级的 repeatOnLifecycle 手写版——这也是 MVI 容器在非常规宿主环境下需要本土化的典型案例。