在 Swift 中，downloadTask 是 URLSession 提供的一个方法，用于下载数据并将其保存到本地文件系统。使用 downloadTask 时，文件会被下载到一个临时文件路径，并且下载完成后可以通过回调中的 localURL 来获取该文件的位置。
基本步骤
1、创建一个 URLSession 实例。
2、使用 downloadTask(with:) 方法发起下载请求。
3、在回调闭包中处理下载完成的文件，包括获取临时路径、移动文件、处理错误等。
基本语法
let task = URLSession.shared.downloadTask(with: URL) { (localURL, response, error) in
// 下载完成后的处理
}
task.resume() // 启动下载任务✓参数：
URL：请求下载的文件的 URL。
localURL：下载完成后的文件在临时目录中的路径。可以使用这个路径进一步处理下载的文件（例如，移动到应用的持久存储位置）。
response：HTTP 响应（包含状态码、头信息等）。
error：下载过程中可能发生的错误。
参数解析
1、localURL
类型：URL?
描述：localURL 是下载完成后文件在临时目录中的路径。当文件被下载时，它会被保存到设备的临时存储目录，localURL 是该临时文件的文件路径。可以使用这个路径进行后续的处理（如移动文件、解压缩等）。
注意：localURL 是临时路径，不要将其用作永久存储。系统可能会在需要释放空间时删除这些文件。为了确保文件不会丢失，通常会将其移动到应用的持久化存储目录（如 Documents）。
示例：
if let localURL = localURL {
print("下载文件的临时路径：\(localURL)")
}✓2、response
类型：URLResponse?
描述：response 是服务器返回的响应信息。它包含 HTTP 响应头和一些其他信息，例如响应的状态码、内容类型、服务器名称等。可以通过 response 获取有关请求的详细信息。
如果正在处理 HTTP 请求，response 会是 HTTPURLResponse 类型，并且可以访问状态码（statusCode）、头信息（allHeaderFields）等。
示例：
if let response = response as? HTTPURLResponse {
print("HTTP 响应状态码: \(response.statusCode)")
print("响应头信息: \(response.allHeaderFields)")
}✓如果下载的是非 HTTP 内容（例如 FTP 或文件协议），则 response 会是 URLResponse 类型，不会有 HTTP 特有的属性。
3、error
类型：Error?
描述：error 参数表示下载过程中发生的任何错误。如果请求成功且没有任何问题，error 为 nil。如果出现网络问题、文件不存在、权限不足等错误，error 会包含具体的错误信息。
可以使用这个参数来检测请求是否成功，并在发生错误时执行相应的错误处理代码。
示例：
if let error = error {
print("下载文件时出错：\(error.localizedDescription)")
}✓代码示例
假设下载一个文件并将它移动到应用的 Documents 目录中，下面是一个完整的代码示例：
import Foundation
// 下载文件的方法
func downloadFile() {
// 创建文件管理器
let fileManager = FileManager.default
// 目标文件URL
guard let fileURL = URL(string: "https://example.com/path/to/file.zip") else { return }
// 获取Documents目录路径
let documentsURL = fileManager.urls(for: .documentDirectory, in: .userDomainMask).first!
let destinationURL = documentsURL.appendingPathComponent("downloadedFile.zip")
// 使用URLSession的downloadTask来下载文件
let task = URLSession.shared.downloadTask(with: fileURL) { localURL, response, error in
if let error = error {
print("下载失败: \(error)")
return
}
// 下载成功，localURL指向文件在临时目录中的路径
if let localURL = localURL {
print("文件已下载到临时路径：\(localURL)")
// 尝试将文件移动到应用的Documents目录
do {
try fileManager.moveItem(at: localURL, to: destinationURL)
print("文件已移动到：\(destinationURL)")
} catch {
print("移动文件时出错：\(error)")
}
}
}
// 启动下载任务
task.resume()
}✓解释：
1、创建文件管理器：使用 FileManager.default 获取文件管理器，用于处理文件系统操作。
2、文件下载 URL：需要指定要下载的文件的 URL。
3、指定目标文件路径：documentsURL.appendingPathComponent(“downloadedFile.zip”) 将文件保存到应用的 Documents 目录。
4、调用 downloadTask：通过 URLSession.shared.downloadTask(with:) 来发起下载任务。下载完成后，localURL 会返回文件在临时目录中的路径。
5、移动文件：下载的文件默认保存在临时目录，因此需要将其移动到持久化存储目录（如 Documents），这样即使应用关闭，文件依然保留。
注意事项
downloadTask 下载的文件在临时目录中。如果不希望文件丢失，必须将文件移到持久化目录（如 Documents）。
downloadTask 会返回一个临时文件路径，而不是直接返回文件的内容。
例如，Xcode模拟器返回下面的地址。
file:///Users/fangjunyu/Library/Developer/Xcode/UserData/Previews/Simulator%20Devices/DE733730-2C79-48CC-A1DF-6B32D409600A/data/Containers/Data/Application/99B4C01F-337D-47FA-BE68-377E3FABA060/tmp/CFNetworkDownload_botZeO.tmp✓如果需要访问文件内容（例如解析文件），可以通过 localURL 获取文件路径并加载它。
总结
downloadTask 是一个非常有用的工具，适用于下载文件并将其保存到本地。通过下载完成后的 localURL，可以将文件移动到应用的持久存储位置（例如 Documents 目录）。
相关文章
1、Swift常用的文件下载方法：https://fangjunyu.com/2024/10/31/swift%e5%b8%b8%e7%94%a8%e7%9a%84%e6%96%87%e4%bb%b6%e4%b8%8b%e8%bd%bd%e6%96%b9%e6%b3%95/
2、Swift 管理文件的FileManager类：https://fangjunyu.com/2024/11/03/swift-%e7%ae%a1%e7%90%86%e6%96%87%e4%bb%b6%e7%9a%84filemanager%e7%b1%bb/
