如何为特定iOS版本标记IBOutlet？同控制器兼容旧版PDF显示

嘿，这个混合版本适配的需求我之前帮不少开发者解决过，给你一套完整的实现方案：

你完全不需要给整个VC加@available(iOS 11.0, *)，那样旧系统直接用不了这个页面，完全违背兼容的初衷。正确的做法是只给依赖iOS11+的代码块、属性单独标记版本限制，让整个VC保持跨版本兼容。

举个核心代码示例：

import UIKit
// iOS11+才导入PDFKit，旧系统会自动忽略这个导入
@available(iOS 11.0, *)
import PDFKit

class PDFViewController: UIViewController {
    // iOS11+专属的PDFView，加版本标记
    @available(iOS 11.0, *)
    @IBOutlet weak var pdfKitView: PDFView!
    
    // 旧版iOS用的UIWebView（如果最低支持iOS13+，可以换WKWebView）
    @IBOutlet weak var legacyWebView: UIWebView!

    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 根据系统版本切换视图逻辑
        if #available(iOS 11.0, *) {
            legacyWebView.isHidden = true
            setupPDFKit()
        } else {
            // 旧系统里pdfKitView会被自动忽略，所以加可选链避免崩溃
            pdfKitView?.isHidden = true
            setupLegacyWebView()
        }
    }
    
    // 仅iOS11+可用的PDFKit初始化方法
    @available(iOS 11.0, *)
    private func setupPDFKit() {
        guard let pdfURL = Bundle.main.url(forResource: "targetPDF", withExtension: "pdf") else { return }
        pdfKitView.document = PDFDocument(url: pdfURL)
        pdfKitView.autoScales = true
        pdfKitView.displayMode = .singlePageContinuous
    }
    
    // 旧版系统的UIWebView初始化
    private func setupLegacyWebView() {
        guard let pdfURL = Bundle.main.url(forResource: "targetPDF", withExtension: "pdf") else { return }
        legacyWebView.loadRequest(URLRequest(url: pdfURL))
        legacyWebView.scalesPageToFit = true
    }
}

针对不同版本的IBOutlet，只需给对应的属性单独加@available标记即可，Storyboard里的操作也很简单：

• 把PDFView和UIWebView（或WKWebView）都拖到VC的布局里，直接重叠放置就行；
• 分别给两个视图创建IBOutlet，给PDFView的IBOutlet加上@available(iOS 11.0, *)；
• 旧版系统运行时，会自动忽略带版本标记的IBOutlet，所以访问它的时候记得加可选链（比如pdfKitView?.isHidden = true），避免空指针崩溃。

要是UIWebView的PDF显示效果差、功能少，你可以用支持低版本iOS的第三方PDF库，比如开源的VFRReader、FastPdfKit，或者商用的PSPDFKit。用法和上面的逻辑一致，在旧版本分支里初始化第三方视图即可：

private func setupThirdPartyPDFView() {
    guard let pdfURL = Bundle.main.url(forResource: "targetPDF", withExtension: "pdf") else { return }
    let readerVC = VFRReaderViewController(documentURL: pdfURL)
    // 嵌入当前VC的话，直接添加子视图
    addChild(readerVC)
    readerVC.view.frame = view.bounds
    view.addSubview(readerVC.view)
    readerVC.didMove(toParent: self)
    // 也可以选择push/present跳转
    // navigationController?.pushViewController(readerVC, animated: true)
}

• 永远不要给整个VC加版本标记，否则旧系统直接无法实例化这个页面；
• 一定要在旧版本模拟器/真机上测试，确保分支逻辑正常；
• 如果你最低支持版本是iOS13+，可以用WKWebView替代UIWebView（UIWebView从iOS12开始被废弃）。

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