3. Flow基础回顾：冷流与热流、StateFlow与SharedFlow的区别、在权限场景下的选择

Kotlin Flow 是响应式编程在 Kotlin 协程中的核心抽象。理解冷流（Cold Flow）与热流（Hot Flow）的本质区别，以及 StateFlow 与 SharedFlow 的设计差异，是正确选择权限状态管理方案的前提。本章从概念、API 特性到权限场景匹配，建立流式状态管线的选型基础。

3.1 冷流与热流：核心区别

3.2 StateFlow vs SharedFlow：设计差异

StateFlow 是热流的一个变体，始终维护一个当前值（必须初始值非空），且只在值实际改变时发射。它适合表示“状态” —— 如权限是否已授予。

SharedFlow 是更通用的热流，支持配置 replay（重放数量）、extraBufferCapacity（额外缓冲区）、onBufferOverflow（溢出策略）。它既可以像事件总线一样工作（replay=0），也可以提供最新值（replay=1）。

3.3 权限场景下的选择逻辑

1. 持续观察权限状态（如相机权限是否已授予）→ StateFlow 是最佳选择：天然带初始值、去重、最新值缓存。
2. 一次性权限请求结果（如用户点击按钮后发起请求，只关心当前弹窗结果）→ 推荐使用 SharedFlow(replay=0) 或 Channel，避免重复消费历史结果。
3. 多界面共享同一权限回调（如服务层监听权限变更后通知多个 fragment）→ SharedFlow(replay=1) 保证新订阅者能立刻获得最新状态。
4. 权限状态与 UI 状态分离 → 使用 StateFlow 持有不可变的权限组合状态，SharedFlow 发送副作用（如权限拒绝提示事件）。

3.4 代码实现：冷流与热流对比

以下示例展示一个模拟权限检查的冷流与热流差异：

// 冷流：每次 collect 都独立执行权限检查
fun checkPermissionCold(
    permissionName: String
): Flow<PermissionResult> = flow {
    emit(PermissionResult.Checking)
    delay(100) // 模拟异步检查
    val granted = Random.nextBoolean()
    emit(if (granted) PermissionResult.Granted else PermissionResult.Denied)
}

// 热流：使用 StateFlow 持有权限状态，多个 collector 共享
class PermissionStateHolder {
    private val _state = MutableStateFlow<PermissionResult>(PermissionResult.Unknown)
    val state: StateFlow<PermissionResult> = _state.asStateFlow()

    fun update(result: PermissionResult) {
        _state.value = result
    }
}

// 事件流：使用 SharedFlow 广播一次性请求结果
private val _requestEvent = MutableSharedFlow<PermissionResult>(replay = 0)
val requestEvent: SharedFlow<PermissionResult> = _requestEvent.asSharedFlow()

suspend fun requestPermission() {
    _requestEvent.emit(PermissionResult.Granted)
}

// 使用示例（在 ViewModel 中）
fun observePermission() {
    viewModelScope.launch {
        // 冷流：每次 collect 重新执行
        checkPermissionCold(Manifest.permission.CAMERA)
            .collect { result ->
                // 处理结果
            }
    }
    // 热流：订阅已有状态
    viewModelScope.launch {
        permissionStateHolder.state.collect { result ->
            // 状态改变时触发
        }
    }
}

3.5 Flow 类型关系图

下图展示了冷流、热流以及 StateFlow/SharedFlow 在权限场景下的定位关系：

3.6 性能与稳定性注意点

3.7 调试要点

// Flow 调试工具：添加日志观察发射频率
fun <T> Flow<T>.debugLog(tag: String): Flow<T> = this
    .onStart { android.util.Log.d(tag, "collect started") }
    .onEach { android.util.Log.d(tag, "value = $it") }
    .onCompletion { android.util.Log.d(tag, "collect completed") }

// 在 ViewModel 中使用
permissionStateHolder.state
    .debugLog("PermissionState")
    .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), PermissionResult.Unknown)