You need to enable JavaScript to run this app. 使用async/await模式调用URLSession的download方法如何获取下载进度?
优惠活动
大模型
产品
解决方案
定价
更多

使用async/await模式调用URLSession的download方法如何获取下载进度?

问题原因

使用async/await版本的download(for:delegate:)API时,系统会内部接管下载任务的生命周期以处理异步返回结果,你传入的任务级代理默认不会触发urlSession(_:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:)这类进度回调,只有认证、重定向等非进度类的代理方法会被正常调用。

解决方法

推荐3种适配不同场景的实现方案:

方案1:监听下载任务内置的progress属性(最简单,大文件下载推荐)

每个URLSessionTask都自带内置的进度管理对象,不需要依赖代理回调,直接监听该对象的属性即可获取实时进度:

// 先创建下载任务,不直接await
let task = URLSession.shared.downloadTask(with: downloadURL)
// 用Combine监听进度变化,也可使用系统KVO
var cancellable = task.progress.publisher(for: \.fractionCompleted)
    .receive(on: DispatchQueue.main)
    .sink { progress in
        // 此处拿到0~1的进度值,可直接更新UI
        print("当前下载进度:\(progress)")
    }
// 启动任务并await最终结果
task.resume()
let (downloadedURL, response) = try await task.value
// 下载完成后销毁监听即可
cancellable.cancel()

方案2:使用传统全局代理模式(兼容旧代码逻辑)

如果你需要保留原有的代理回调逻辑,可以放弃async/await的便捷写法,初始化URLSession时设置全局代理,所有代理回调都会正常触发:

// 初始化时绑定全局代理
let session = URLSession(configuration: .default, delegate: self, delegateQueue: OperationQueue.main)
// 发起普通下载任务
let task = session.downloadTask(with: downloadURL)
task.resume()
// 你已实现的URLSessionDownloadDelegate进度方法会正常被回调

方案3:使用字节流AsyncSequence逐块处理(仅适合小文件)

如果是小文件下载,也可以直接使用字节流异步序列自己计算进度,注意该方案会把全量文件数据暂存在内存中,大文件场景不推荐使用:

let (byteStream, response) = try await URLSession.shared.bytes(from: downloadURL)
let totalExpectedBytes = response.expectedContentLength
var downloadedBytes = 0
var fileData = Data()

for try await byte in byteStream {
    fileData.append(byte)
    downloadedBytes += 1
    let currentProgress = Double(downloadedBytes) / Double(totalExpectedBytes)
    // 实时更新进度
}
// 下载完成后将data写入本地指定路径即可
try fileData.write(to: yourLocalSaveURL)

内容的提问来源于stack exchange,提问作者Maciej Swic

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 09:45:02