QLPreviewControllerRepresentation未遵循UIViewControllerRepresentable协议问题排查

你的QLPreviewControllerRepresentation结构体不符合UIViewControllerRepresentable协议，核心问题出在协议关联类型的声明和方法返回类型上：

具体错误点 #

• UIViewControllerRepresentable协议要求必须明确指定关联的视图控制器类型UIViewControllerType，你使用了不透明返回类型some QLPreviewController，导致编译器无法自动推断该关联类型，触发协议不兼容错误。
• updateUIViewController方法的第一个参数类型必须与UIViewControllerType完全匹配，原代码中虽然写了QLPreviewController，但因为前面的不透明类型，编译器无法确认两者的一致性。

修正后的代码 #

将QLPreviewControllerRepresentation替换为以下代码：

struct QLPreviewControllerRepresentation: UIViewControllerRepresentable {
    @Binding var fileURL: URL?
    
    // 显式声明协议要求的关联类型
    typealias UIViewControllerType = QLPreviewController
    
    func makeUIViewController(context: Context) -> QLPreviewController {
        let controller = QLPreviewController()
        controller.dataSource = context.coordinator
        return controller
    }

    func updateUIViewController(_ uiViewController: QLPreviewController, context: Context) {
        uiViewController.reloadData()
    }

    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }

    class Coordinator: NSObject, QLPreviewControllerDataSource {
        let parent: QLPreviewControllerRepresentation

        init(_ parent: QLPreviewControllerRepresentation) {
            self.parent = parent
        }

        func numberOfPreviewItems(in controller: QLPreviewController) -> Int {
            return parent.fileURL != nil ? 1 : 0
        }

        func previewController(_ controller: QLPreviewController, previewItemAt index: Int) -> QLPreviewItem {
            // 替换强制解包为安全解包，避免崩溃
            guard let url = parent.fileURL else {
                return URL(fileURLWithPath: "") as QLPreviewItem
            }
            return url as QLPreviewItem
        }
    }
}

额外优化建议 #

原代码中将预览控制器放在background中的做法不符合SwiftUI常规交互逻辑，建议改用模态方式展示，比如在body中替换background部分为：

.sheet(item: $fileToPreview) { _ in
    QLPreviewControllerRepresentation(fileURL: $fileToPreview)
}

这样用户点击"Voir la facture"按钮下载完成后，会自动弹出预览控制器，交互体验更流畅。

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