iOS PDFKit墨水注释渲染异常问题求助

我之前也踩过PDFKit里Ink注释的这个坑，咱们来一步步拆解问题根源，再给出符合PDF规范的修复方案：

问题根源分析 #

你遇到的默认注释不显示/渲染异常，核心是三个细节没符合PDFKit的要求：

1. inklist属性的类型错误：PDFKit要求PDFAnnotationKey.inklist对应的值必须是[CGPath]数组，但你传的是[UIBezierPath]，底层解析失败直接导致注释不渲染。
2. 坐标空间不匹配：UIKit的坐标原点在左上角，而PDF的坐标原点在左下角。如果你的路径是基于UIKit视图坐标创建的，直接计算的bounds会和PDF页面的坐标空间错位，导致注释被画到了页面可见区域之外。
3. 冗余操作干扰：你既在属性字典里传了inklist，又调用annotation.add(path)重复添加路径，这会让PDFKit的渲染逻辑混乱。

符合PDF规范的修复代码 #

把原来的代码改成下面这样，就能让默认Ink注释正常渲染：

// 假设你已经有了UIBezierPath类型的paths数组，先转成CGPath适配PDFKit
let cgPaths = paths.map { $0.cgPath }

// 计算所有路径的包围盒，预留一些边距
var bounds = cgPaths.reduce(CGMutablePath(), { acc, nxt in
    acc.addPath(nxt)
    return acc
}).boundingBoxOfPath.insetBy(dx: -50, dy: -50)

// 关键：把UIKit坐标转换成PDF页面坐标（替换成你的目标PDFPage）
let pageCropBox = pdfPage.bounds(for: .cropBox)
bounds = CGRect(
    x: bounds.minX,
    y: pageCropBox.height - bounds.maxY, // 翻转y轴适配PDF坐标
    width: bounds.width,
    height: bounds.height
)

let border = PDFBorder()
border.lineWidth = 2.5
border.style = .solid

// 创建符合规范的Ink注释
annotation = PDFAnnotation(
    bounds: bounds,
    forType: .ink,
    withProperties: [
        PDFAnnotationKey.inklist: cgPaths, // 这里必须传CGPath数组
        PDFAnnotationKey.border: border,
        PDFAnnotationKey.color: UIColor.red, // 墨水注释用color控制线条颜色
    ])

annotation.shouldDisplay = true
// 不需要再调用annotation.add(path)，也不需要设置backgroundColor/interiorColor

为什么子类化重写draw能正常工作？ #

因为你重写draw(with:in:)时，直接绕开了PDFKit默认的注释解析逻辑，自己用CGContext处理了路径绘制和坐标转换，相当于手动实现了渲染，自然不会触发原来的解析bug。但这种方式虽然能工作，却没有利用PDFKit内置的注释管理能力（比如导出PDF时注释的兼容性、编辑交互等），所以还是推荐用上面的规范方案。

额外注意事项 #

• 如果你是通过手势在PDFView上绘制路径，记得用PDFView.convert(_:to:)方法把触摸坐标直接转换成PDF页面坐标，这样就不用手动翻转y轴了。
• 确保bounds的范围完全落在PDF页面的cropBox或mediaBox内，超出页面的部分可能不会被渲染。

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