如何从协程更新Jetpack Compose中LinearProgressIndicator的进度

要实现进度的实时更新，核心是让processFiles()在执行过程中把进度数据传递到Composable组件中，具体可以通过给挂起函数添加进度回调的方式实现，步骤如下：

1. 修改processFiles()函数，添加进度回调参数 #

给这个非Composable的挂起函数新增一个lambda参数，用于在任务执行过程中实时传递已完成的进度值：

suspend fun processFiles(onProgressUpdate: (completed: Long) -> Unit): String? {
    // 假设原有逻辑中存在循环处理文件/数据的流程
    for (item in itemsToProcess) {
        // 执行具体的处理逻辑
        handleSingleItem(item)
        
        // 计算当前已完成的总量（比如字节数、文件数等）
        val currentCompleted = calculateCompletedAmount()
        // 调用回调传递进度
        onProgressUpdate(currentCompleted)
    }
    
    // 返回失败原因（如果有）
    return if (hasError()) "处理失败" else null
}

2. 在Composable中利用回调更新状态并自动计算进度 #

在ConfigureFilesScreen里，我们可以用derivedStateOf自动计算进度值（避免手动维护copyProgress的更新），同时在调用processFiles()时传入回调更新已完成量：

@Composable
fun ConfigureFilesScreen() {
    var copyTotal by remember { mutableStateOf(0L) }
    var copyCompleted by remember { mutableStateOf(0L) }
    var failedReason by remember { mutableStateOf<String?>(null) }

    // 自动计算进度：仅当copyCompleted或copyTotal变化时重新计算
    val copyProgress by remember(copyCompleted, copyTotal) {
        derivedStateOf {
            if (copyTotal == 0L) 0f else copyCompleted.toFloat() / copyTotal
        }
    }

    // 显示进度条
    LinearProgressIndicator(progress = copyProgress)

    LaunchedEffect(key1 = true) {
        // 先获取总任务量
        copyTotal = preflightFiles()
        // 调用带进度回调的processFiles
        failedReason = processFiles { completed ->
            // 确保在主线程更新Compose状态（如果回调在后台线程触发）
            withContext(Dispatchers.Main) {
                copyCompleted = completed
            }
        }
    }

    // 其他UI组件逻辑...
}

关键说明 #

• derivedStateOf的优势：它会创建一个依赖于其他State的派生状态，只有当依赖的copyCompleted或copyTotal变化时，才会重新计算copyProgress，避免不必要的UI重绘，提升性能。
• 线程安全：如果processFiles()的进度回调是在后台线程执行的，必须用withContext(Dispatchers.Main)切换到主线程更新Compose状态，因为Compose的UI状态更新必须在主线程进行。

内容的提问来源于stack exchange，提问作者randallmeadows