用途:在 iOS 与 iPadOS 应用中实现绘图、素描与批注能力,基于 PencilKit(PKCanvasView、PKToolPicker、PKDrawing)与 PaperKit,面向 Swift 6.3 / iOS 26+。
主要能力与组件:PKCanvasView 是可滚动的绘图画布,继承自 UIScrollView,接收触摸与 Apple Pencil 输入;PKToolPicker 是浮动的系统工具面板,提供钢笔、铅笔、马克笔、橡皮、直尺及自定义工具;PKDrawing 是不可变数据模型,包含矢量笔画 PKStroke、笔画点与边界;PKTool 表示当前绘图工具(PKInkingTool、PKEraserTool、PKLassoTool);PKCanvasViewDelegate 在绘图变化或用户开始、结束绘制时通知。
使用方式:通过 UIViewRepresentable 将 PKCanvasView 桥接到 SwiftUI,在 makeUIView 中配置 drawingPolicy、tool、isRulerActive 与 delegate,在 updateUIView 中同步 drawing、tool 和 isRulerActive,并用 Coordinator 实现 canvasViewDrawingDidChange 回写绑定。绘图持久化用 drawing.dataRepresentation() 序列化,PKDrawing(data:) 恢复并处理错误;图像生成可用 drawing.image(from:scale:);笔画检查可遍历 drawing.strokes 读取点、压力、力度与方位角。输入策略通过 canvasView.drawingPolicy 设置:default 跟随系统偏好,anyInput 允许手指与 Apple Pencil 同时绘制,pencilOnly 限制为仅 Apple Pencil、手指用于滚动。PKToolPicker 需用 setVisible(:forFirstResponder:) 与 addObserver(:) 绑定,并确保画布成为第一响应者。
适用场景:需要在应用中嵌入手写笔记、草图、标注或自定义绘图工具的交互界面。
限制与注意事项:显示工具面板前需调用 becomeFirstResponder();避免在绘制手势过程中持续更新 SwiftUI 绑定导致卡顿与反馈循环;若需自定义手指滚动手势应设置 drawingPolicy = .pencilOnly;复杂绘图不要在主线程同步生成高分辨率位图;PKToolPicker 在 SwiftUI 中需锚定到窗口或第一响应者。资料未提供具体价格、平台可用范围之外的信息,暂未提供。