Xcode 16.0下NSView布局异常：draw(_:)方法尺寸不符合约束

问题背景 #

在macOS 15.0.1（Sequoia）+ Xcode 16.0环境中，现有项目及新建项目均出现NSView布局异常：通过Auto Layout设置宽高均为100的子NSView，重写draw(_ dirtyRect: NSRect)方法时，获取到的dirtyRect尺寸与父NSView一致，而非预期的100×100。切换Swift 5/6版本后问题依旧，仅当子视图开启wantsLayer=true并通过Layer实现绘制时，布局表现正常。

环境信息 #

• macOS 15.0.1
• Xcode 16.0
• Swift 5 / Swift 6

复现代码 #

private class ViewA: NSView {
    override func draw(_ dirtyRect: NSRect) {
        print("ViewA: \(dirtyRect)")
        NSColor.systemBlue.set()
        dirtyRect.fill()
    }
}

class ViewController: NSViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
 
        view.wantsLayer = true
        view.layer?.backgroundColor = NSColor.white.cgColor
        
        let v1 = ViewA()
        view.addSubview(v1)
        v1.translatesAutoresizingMaskIntoConstraints = false
        
        NSLayoutConstraint.activate([
            v1.centerXAnchor.constraint(equalTo: view.centerXAnchor),
            v1.centerYAnchor.constraint(equalTo: view.centerYAnchor),
            v1.heightAnchor.constraint(equalToConstant: 100),
            v1.widthAnchor.constraint(equalToConstant: 100)
        ])
    }
    
    override func viewDidLayout() {
        super.viewDidLayout()
        print("VC.view = \(view.frame)")
    }
}

现象对比 #

当前异常表现 #

draw(_:)方法中打印的dirtyRect与父视图尺寸一致，绘制的蓝色区域铺满父视图：

预期表现 #

蓝色区域为100×100居中显示，使用Layer实现可达成该效果：

let v1 = NSView()
v1.wantsLayer = true
v1.layer?.backgroundColor = NSColor.systemBlue.cgColor

解决方案 #

针对该问题，提供三种有效修复方式：

1. 为子视图开启图层支持 #

即使需要使用draw(_:)方法，开启wantsLayer=true后，Auto Layout约束会正确同步到视图frame，dirtyRect也会匹配视图实际尺寸：

private class ViewA: NSView {
    override init(frame frameRect: NSRect) {
        super.init(frame: frameRect)
        wantsLayer = true
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        wantsLayer = true
    }
    
    override func draw(_ dirtyRect: NSRect) {
        print("ViewA: \(dirtyRect)")
        NSColor.systemBlue.set()
        dirtyRect.fill()
    }
}

2. 绘制时使用视图bounds替代dirtyRect #

dirtyRect表示需要重绘的区域，在异常场景下计算有误；而bounds是视图的实际可用区域，直接使用它绘制可确保尺寸正确：

private class ViewA: NSView {
    override func draw(_ dirtyRect: NSRect) {
        print("ViewA bounds: \(self.bounds)")
        NSColor.systemBlue.set()
        self.bounds.fill()
    }
}

3. 布局完成后主动触发重绘 #

在子视图中重写viewDidLayout，布局更新后调用setNeedsDisplay，确保绘制时使用最新的布局结果：

private class ViewA: NSView {
    override func viewDidLayout() {
        super.viewDidLayout()
        setNeedsDisplay(bounds)
    }
    
    override func draw(_ dirtyRect: NSRect) {
        print("ViewA: \(dirtyRect)")
        NSColor.systemBlue.set()
        dirtyRect.fill()
    }
}

问题原因推测 #

该问题大概率是Xcode 16.0与macOS 15.0.1的AppKit布局-绘制流程兼容性问题：非图层-backed的视图中，Auto Layout的约束更新未及时同步到绘制阶段的dirtyRect计算逻辑，导致绘制时错误使用了父视图的区域。开启图层支持后，视图布局由Core Animation管理，能更精准地同步约束结果与绘制区域。

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