如何在FinderSync的menuForMenuKind中添加自定义NSMenuItem并解决视图不显示问题

我正尝试在Swift/Cocoa环境下为Finder Sync扩展创建自定义NSMenuItem，编写了如下代码：

override func menu(for menuKind: FIMenuKind) -> NSMenu {
    // Produce a menu for the extension.
    let menu = NSMenu(title: "")
    let v = NSView(frame: NSMakeRect(0, 0, 100, 30))
    v.wantsLayer = true
    v.layer?.backgroundColor = NSColor.cyan.cgColor
    let newItem = NSMenuItem()
    newItem.view = v
    newItem.target = self
    menu.insertItem(newItem, at: 0)
    return menu
}

但该代码中设置的青色视图并未在FinderSync扩展菜单中显示，请问如何在menuForMenuKind中添加自定义视图？

我懂你现在的困扰——明明逻辑上没问题，就是看不到自定义的青色视图。其实Finder Sync扩展对NSMenuItem的自定义视图有几个容易忽略的特殊限制，咱们一步步调整代码就能解决：

核心问题与修复步骤 #

• 必须显式设置MenuItem的高度：Finder不会自动根据视图尺寸调整MenuItem的高度，默认高度很小，你的视图会被压缩到几乎看不见，所以得手动指定高度
• 优化视图的Autoresizing Mask：确保视图能正确填充MenuItem的可用空间，避免出现裁剪或留白
• 确认视图的启用状态：如果MenuItem被禁用，自定义视图也可能不会被渲染

修改后的完整代码 #

override func menu(for menuKind: FIMenuKind) -> NSMenu {
    let menu = NSMenu(title: "")
    
    // 1. 定义视图尺寸，建议预留一点边距避免视觉上太拥挤
    let viewFrame = NSMakeRect(0, 0, 200, 32)
    let customView = NSView(frame: viewFrame)
    
    // 2. 启用Layer并设置背景色
    customView.wantsLayer = true
    customView.layer?.backgroundColor = NSColor.cyan.cgColor
    
    // 3. 设置自动调整掩码，让视图横向填充MenuItem的宽度
    customView.autoresizingMask = [.width]
    
    // 4. 创建MenuItem并绑定视图，关键步骤：手动指定高度
    let customItem = NSMenuItem()
    customItem.view = customView
    customItem.height = viewFrame.size.height // 这一步是视图显示的关键
    customItem.isEnabled = true // 确保Item处于启用状态
    customItem.target = self // 保留你原来的target设置
    
    menu.insertItem(customItem, at: 0)
    return menu
}

额外注意事项 #

• 菜单类型兼容性：不是所有FIMenuKind都支持自定义视图，比如FIMenuKind.contextualMenuForItems（文件右键菜单）是完全支持的，而部分系统级菜单可能有限制，建议先在常用场景测试
• 避免复杂视图：Finder菜单对自定义视图的性能要求很高，尽量使用轻量的NSView子类，比如添加NSTextField时要显式设置字体、颜色和对齐方式，避免显示异常
• 调试小技巧：可以给视图加个红色边框快速排查问题：

  customView.layer?.borderColor = NSColor.red.cgColor
  customView.layer?.borderWidth = 1
  

  这样能快速判断是视图没被渲染，还是尺寸设置不对导致被隐藏

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