如何在SwiftUI中结合.onDrag使用NSFilePromiseProvider？

嘿，我完全懂你遇到的这个问题——在AppKit里用文件承诺实现远程文件拖拽顺风顺水，到了SwiftUI里用onDrag的时候，发现registerFileRepresentation非得要本地已存在的文件，这不就卡壳了嘛！其实解决方案是有的，我们可以用NSFilePromiseProvider，它就是苹果专门为文件承诺场景设计的，而且能完美适配SwiftUI的onDrag。

核心思路 #

文件承诺的关键在于延迟文件获取：不是在拖拽开始时就提供本地文件，而是等用户把拖拽项放到目标位置（比如桌面）后，再去下载远程文件并交付给系统。NSFilePromiseProvider正是干这个的，它会在合适的时机触发我们的下载逻辑。

完整代码实现 #

第一步：实现文件承诺代理

首先我们需要一个NSFilePromiseProviderDelegate的子类，用来处理文件名返回、文件下载交付的逻辑：

import SwiftUI
import UniformTypeIdentifiers

class FilePromiseDelegate: NSObject, NSFilePromiseProviderDelegate {
    private let remoteFileURL: URL
    private let fileName: String
    
    init(remoteFileURL: URL, fileName: String) {
        self.remoteFileURL = remoteFileURL
        self.fileName = fileName
        super.init()
    }
    
    // 告诉系统我们承诺的文件名
    func filePromiseProvider(_ provider: NSFilePromiseProvider, fileNameForTypeIdentifier typeIdentifier: String) -> String {
        return fileName
    }
    
    // 当用户完成拖拽，系统需要文件时，在这里下载并交付
    func filePromiseProvider(_ provider: NSFilePromiseProvider, writePromiseTo url: URL, completionHandler: @escaping (Error?) -> Void) {
        // 用URLSession异步下载远程文件
        let downloadTask = URLSession.shared.downloadTask(with: remoteFileURL) { tempDownloadURL, response, error in
            if let error = error {
                // 下载失败，把错误传给系统
                completionHandler(error)
                return
            }
            
            guard let tempURL = tempDownloadURL else {
                let noTempFileError = NSError(domain: "YourAppDomain", code: -1, userInfo: [
                    NSLocalizedDescriptionKey: "无法获取临时下载文件"
                ])
                completionHandler(noTempFileError)
                return
            }
            
            do {
                // 将临时下载的文件移动到系统指定的目标路径
                try FileManager.default.moveItem(at: tempURL, to: url)
                // 完成交付，没有错误
                completionHandler(nil)
            } catch {
                completionHandler(error)
            }
        }
        
        downloadTask.resume()
    }
    
    // 可选：自定义拖拽时显示的缩略图
    func filePromiseProvider(_ provider: NSFilePromiseProvider, thumbnailImageForTypeIdentifier typeIdentifier: String, size: NSSize) -> NSImage? {
        return NSImage(systemSymbolName: "doc", accessibilityDescription: fileName)
    }
}

第二步：在SwiftUI视图中使用

接下来在你的ContentView里，用onDrag返回NSFilePromiseProvider（它是NSItemProvider的子类，所以直接符合要求）：

struct ContentView: View {
    // 替换成你的远程文件URL和想要保存的文件名
    let remoteFileURL = URL(string: "https://example.com/your-remote-document.pdf")!
    let targetFileName = "my-downloaded-file.pdf"
    
    var body: some View {
        Text("拖拽我到桌面下载文件")
            .font(.title)
            .padding()
            .background(.blue)
            .foregroundColor(.white)
            .cornerRadius(8)
            .onDrag {
                // 创建文件承诺Provider，指定文件类型和代理
                let filePromise = NSFilePromiseProvider(
                    fileType: UTType.pdf.identifier,
                    delegate: FilePromiseDelegate(remoteFileURL: remoteFileURL, fileName: targetFileName)
                )
                // 直接返回，因为NSFilePromiseProvider继承自NSItemProvider
                return filePromise as NSItemProvider
            }
    }
}

关键细节说明 #

• 文件类型适配：把UTType.pdf.identifier换成你需要的类型，比如UTType.text.identifier（文本文件）、UTType.image.png.identifier（PNG图片）等。
• 错误处理：一定要正确传递错误给completionHandler，这样系统能向用户提示拖拽失败的原因。
• 异步下载：用URLSession的异步任务处理下载，避免阻塞主线程，保证UI流畅。
• 自定义缩略图：实现thumbnailImageForTypeIdentifier方法可以让拖拽时显示更贴合文件类型的图标，提升用户体验。

额外注意事项 #

• 如果是大文件下载，你可以在代理类里添加进度跟踪逻辑，结合SwiftUI的@Published属性把进度传递到视图中显示。
• 确保你的App有网络访问权限（在Info.plist里添加NSAppTransportSecurity相关配置，如果需要访问HTTP站点）。

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