跨平台App中NSPanGesture在AppKit失效，UIPanGesture在iOS正常

问题诊断与修复方案 #

1. 开启NSView的事件接收能力 #

AppKit中NSView默认不接收触摸事件，需显式开启，否则手势识别器无法触发：

class HorizontalPanGestureReceiverView: NSView {
    weak var delegate: HorizontalPanGestureReceiverViewDelegate?
    
    override init(frame frameRect: NSRect) {
        super.init(frame: frameRect)
        acceptsTouchEvents = true // 开启触摸事件支持
        wantsLayer = true // 确保视图正常渲染与事件响应
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    override func touchesEnded(with event: NSEvent) {
        super.touchesEnded(with: event)
        delegate?.viewTouchedWithoutPan(self)
    }
}

2. 修正NSGestureRecognizerDelegate方法签名 #

AppKit中该代理方法的参数是NSEvent而非NSTouch，原代码方法不会被调用，导致手势接收逻辑失效：

// 替换macOS Coordinator中的对应方法
func gestureRecognizer(_ gestureRecognizer: NSGestureRecognizer, shouldReceive event: NSEvent) -> Bool {
    beginTouch()
    return true
}

3. 让手势视图占满父容器 #

原代码中手势视图是固定42x42大小，可能无法覆盖滑块区域，修改为自适应父容器：

func makeNSView(context: Context) -> some NSView {
    let view = HorizontalPanGestureReceiverView(frame: .zero)
    view.autoresizingMask = [.width, .height] // 自动适配父视图大小
    let pgr = NSPanGestureRecognizer(target: context.coordinator, action: #selector(Coordinator.panGestureHandler(_:)))
    view.delegate = context.coordinator
    pgr.delegate = context.coordinator
    pgr.allowedTranslationTypes = .horizontal // 限制仅水平拖拽
    view.addGestureRecognizer(pgr)
    context.coordinator.view = view

    return view
}

4. 修复CVDisplayLink的主线程调用问题 #

macOS的CVDisplayLink回调默认在后台线程执行，直接更新UI会导致异常，需切换到主线程：

// 修改macOS SynchedTimer的displayLinkTick方法
@objc private func displayLinkTick() {
    guard isRunning else { return }
    
    DispatchQueue.main.async { [weak self] in
        guard let self = self, self.isRunning else { return }
        
        let currentTimeStamp = CACurrentMediaTime()
        let progress = currentTimeStamp - self.startTimeStamp
        let elapsed = currentTimeStamp - self.lastTimeStamp
        self.lastTimeStamp = currentTimeStamp
        
        if progress < self.duration {
            self.animationBlock(progress, elapsed)
        } else {
            self.complete()
        }
    }
}

5. 完善手势状态处理 #

NSPanGestureRecognizer需手动重置translation，避免累积偏移：

@objc func panGestureHandler(_ gesture: NSPanGestureRecognizer) {
    let translation = gesture.translation(in: view)
    let velocity = gesture.velocity(in: view)
    let location = gesture.location(in: view)
    let startLocation = location - translation

    let value = HorizontalDragGestureValue(state: gesture.state,
                                           translation: .init(horizontal: translation.x),
                                           velocity: velocity.x,
                                           startLocation: startLocation,
                                           location: location)
    self.action(value)
    
    // 重置translation，避免后续手势累积偏移
    if gesture.state == .ended || gesture.state == .cancelled {
        gesture.setTranslation(.zero, in: view)
    }
}

调试建议 #

• 在panGestureHandler中添加打印语句，确认手势是否被触发及状态变化
• 检查SwiftUI视图层级，确保overlay的手势视图正确覆盖滑块区域
• 验证horizontalDragAction(withValue:)方法是否正确处理macOS的手势状态

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