iPad适配模式下Mac端SwiftUI中PDFView链接注解失效问题

在「专为iPad设计」的Mac应用（Mac Catalyst）环境下，PDFView的链接交互存在特殊的事件处理限制，默认的链接点击逻辑可能无法正常触发，核心原因是UIViewRepresentable的视图层级包裹和Mac Catalyst的事件响应链差异。以下是具体的调整方案：

1. 修正UIViewRepresentable的视图返回类型 #

原代码中返回UIView会额外包裹一层视图，可能导致点击事件无法传递到内部的PDFView。直接返回PDFView可以保证事件响应链的正确传递：

import PDFKit
import SwiftUI

struct MyPDFView: UIViewRepresentable {
    // 将返回类型从UIView改为PDFView
    func makeUIView(context: Context) -> PDFView {
        guard let path = Bundle.main.path(forResource: "basic-link-1", ofType: "pdf"),
              let url = URL(fileURLWithPath: path),
              let pdfDocument = PDFDocument(url: url) else {
            return PDFView()
        }

        let pdfView = PDFView()
        pdfView.document = pdfDocument
        pdfView.autoScales = true
        pdfView.isUserInteractionEnabled = true
        // 绑定代理到Coordinator
        pdfView.delegate = context.coordinator
        return pdfView
    }
    
    func updateUIView(_ uiView: PDFView, context: Context) {}
    
    // 实现Coordinator作为PDFView代理
    func makeCoordinator() -> Coordinator {
        Coordinator()
    }
    
    class Coordinator: NSObject, PDFViewDelegate {
        // 处理URL类型的链接点击
        func pdfViewWillClick(onLink sender: PDFView, url: URL) {
            handleLinkTap(sender: sender, url: url)
        }
        
        // 处理PDF内部目的地跳转的链接
        func pdfView(_ sender: PDFView, didTapOnLink destination: PDFDestination, at point: CGPoint) {
            sender.go(to: destination)
        }
        
        private func handleLinkTap(sender: PDFView, url: URL) {
            switch url.scheme {
            case "http", "https":
                // 打开外部网页
                UIApplication.shared.open(url)
            case "page":
                // 处理文档内页面跳转（根据你的PDF链接格式调整逻辑）
                if let pageIndex = url.host.flatMap(Int.init),
                   let targetPage = sender.document?.page(at: pageIndex - 1) {
                    sender.go(to: targetPage)
                }
            default:
                // 其他类型链接按需处理
                break
            }
        }
    }
}

2. 关键调整说明 #

• 直接返回PDFView：避免额外的视图层级拦截点击事件，确保PDFView能直接接收用户交互。
• 手动实现代理逻辑：Mac Catalyst下默认的链接自动跳转机制可能失效，通过PDFViewDelegate的回调手动处理链接，保证点击事件被捕获并执行对应动作。
• 兼容两种链接类型：同时处理URL类型的链接和PDF内部目的地跳转，覆盖不同的PDF链接注解场景。

3. 额外检查项 #

• 若需打开外部HTTP链接，需在Info.plist中添加NSAppTransportSecurity配置，允许HTTP请求（HTTPS链接默认支持）：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

• 确认应用沙箱权限未限制网络访问（「专为iPad设计」的应用默认继承iPad的沙箱设置，若有调整需在项目配置中确认）。

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