重构SwiftUI的.onDrop代码至独立文件后编译失败求助

我有一个包含Image组件的SwiftUI View，通过.onDrop修饰符实现拖拽文件URL到Image上的功能：拖拽后会处理每个URL，短暂显示生成的图片替代状态栏。原代码使用@State变量可正常运行，但代码长度超过40行，放在View中过于臃肿。尝试将这部分逻辑封装到独立struct时，编译报错“Escaping closure captures 'inout' parameter”，未找到相关解决示例，折腾过程中还导致MacBook崩溃。

可正常运行的原代码 #

.onDrop(of: [.fileURL], isTargeted: $isTargeted) { providers in
    // 接收新URL前清空数组
    imageList.removeAll()
    isNewDrop = true // 在.notify中重置
    let dispatchGroup = DispatchGroup()
    
    for provider in providers {
        dispatchGroup.enter()
        _ = provider.loadObject(ofClass: URL.self) { url, error in
            defer { dispatchGroup.leave() }
            
            if let url = url {
                if url.isFileURL && url.pathExtension == "raw" {
                    thisImageBuilder = ImageBuilder() 
                }
                if !thisImageBuilder!.newFile(fileURL: url, isNewTransect: isNewDrop ) {
                    fatalError("Failed to build GCImage.")
                }
                // transect静态变量已完全初始化
                // 显示图片
                imageList.append(thisImageBuilder!)
                currentDatum = thisImageBuilder! // 给查看器的UI优化
                imageCaption = thisImageBuilder!.displayName
                isNewDrop = false
            } else {
                // TODO 处理非文件URL（比如目录）
                print("ImageView: Invalid URL: \(url)")
            }
        } else if let error = error {
            // TODO 处理URL加载时的错误
            print("ImageView: Error loading URL: \(error.localizedDescription)")
        }
    } // 加载对象即拖放处理
    
    // 所有数据读取处理完成
    dispatchGroup.notify(queue: .main) { 
        // 后处理：显示第一张图片并设置索引
        isNewDrop = false 
        currentDatum = imageList.first  // 显示第一张图片
        imageCaption = currentDatum!.displayName
        isTargeted = false 
        maxImageIndex = imageList.count - 1
        thisImageIndex = 0 // 拖放的第一张图片
    }
    return true // 表示接受拖放
} // onDrop结束

重构后无法编译的代码 #

import SwiftUI

struct URLDropHandler {

    mutating func handleDroppedFiles(providers: [NSItemProvider], isNewDrop: inout Bool, imageCaption: inout String, isTargeted: inout Bool, thisImageIndex: inout Int, maxImageIndex: inout Int, imageList: inout [ImageBuilder]?, currentDatum: inout ImageBuilder?) {

        imageList?.removeAll()
        isNewDrop = true // 在.notify中重置

        let dispatchGroup = DispatchGroup()

        for provider in providers {
            dispatchGroup.enter()
            _ = provider.loadObject(ofClass: URL.self) { url, error in
                defer { dispatchGroup.leave() }

                if let url = url, url.isFileURL, url.pathExtension == "raw" {
                    let thisImageBuilder = ImageBuilder()
                    if !thisImageBuilder.newFile(fileURL: url, isNewTransect: isNewDrop) { // 每个变量都报错误
                        fatalError("Failed to build CGImage.")
                    }
                    imageList?.append(thisImageBuilder)
                    currentDatum = thisImageBuilder // 给查看器的UI优化
                    imageCaption = thisImageBuilder.displayName
                    isNewDrop = false
                } else {
                    print("Invalid URL: \(url?.absoluteString ?? "nil")")
                }
            }
        } // 遍历providers结束

        dispatchGroup.notify(queue: .main) { // 每个变量都报错误
            isNewDrop = false // TODO 验证此逻辑
            imageCaption = currentDatum?.displayName ?? ""
            isTargeted = false // TODO 验证此逻辑
            thisImageIndex = 0 // 拖放的第一张图片
            maxImageIndex = (imageList?.count ?? 0) - 1
            currentDatum = imageList?.first  // 显示第一张图片
        }
    }
}

解决方案：用ViewModel封装状态，避免inout参数逃逸 #

错误根源是逃逸闭包（loadObject的completion和dispatchGroup.notify）捕获了inout参数，Swift不允许这种操作——inout参数的生命周期无法保证与逃逸闭包一致。

正确的重构方式是把所有需要修改的状态变量封装到一个ViewModel类（引用类型）里，闭包捕获ViewModel实例即可，无需使用inout：

1. 创建ViewModel类 #

import SwiftUI

class DropHandlerViewModel: ObservableObject {
    @Published var isNewDrop = false
    @Published var imageCaption = ""
    @Published var isTargeted = false
    @Published var thisImageIndex = 0
    @Published var maxImageIndex = 0
    @Published var imageList: [ImageBuilder] = []
    @Published var currentDatum: ImageBuilder?
}

2. 重构URLDropHandler，依赖ViewModel #

struct URLDropHandler {
    func handleDroppedFiles(providers: [NSItemProvider], viewModel: DropHandlerViewModel) {
        // 清空数组
        viewModel.imageList.removeAll()
        viewModel.isNewDrop = true

        let dispatchGroup = DispatchGroup()

        for provider in providers {
            dispatchGroup.enter()
            _ = provider.loadObject(ofClass: URL.self) { url, error in
                defer { dispatchGroup.leave() }
                
                guard let url = url, url.isFileURL, url.pathExtension == "raw" else {
                    print("Invalid URL: \(url?.absoluteString ?? "nil")")
                    return
                }
                
                let imageBuilder = ImageBuilder()
                guard imageBuilder.newFile(fileURL: url, isNewTransect: viewModel.isNewDrop) else {
                    fatalError("Failed to build CGImage.")
                }
                
                DispatchQueue.main.async {
                    viewModel.imageList.append(imageBuilder)
                    viewModel.currentDatum = imageBuilder
                    viewModel.imageCaption = imageBuilder.displayName
                    viewModel.isNewDrop = false
                }
            }
        }

        dispatchGroup.notify(queue: .main) {
            viewModel.isNewDrop = false
            viewModel.currentDatum = viewModel.imageList.first
            viewModel.imageCaption = viewModel.currentDatum?.displayName ?? ""
            viewModel.isTargeted = false
            viewModel.thisImageIndex = 0
            viewModel.maxImageIndex = viewModel.imageList.count - 1
        }
    }
}

3. 在View中使用 #

struct YourImageView: View {
    @StateObject private var dropVM = DropHandlerViewModel()
    private let dropHandler = URLDropHandler()

    var body: some View {
        Image(/* 你的Image配置 */)
            .onDrop(of: [.fileURL], isTargeted: $dropVM.isTargeted) { providers in
                dropHandler.handleDroppedFiles(providers: providers, viewModel: dropVM)
                return true
            }
            // 根据dropVM的状态更新UI，比如显示imageCaption等
    }
}

关键改动说明 #

• 用ObservableObject的ViewModel封装所有状态，替代inout参数，引用类型实例可安全被逃逸闭包捕获
• 在闭包中修改UI相关状态时，显式切换到主线程（DispatchQueue.main.async），确保UI更新在主线程执行
• 用guard语句简化可选值处理，逻辑更清晰

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