SwiftUI调用StatusBarController报ContentView类型参数错误

开发macOS SwiftUI菜单栏应用时，通过ContentView按钮调用StatusBarController方法切换popover显隐时，触发如下报错：

Argument type 'ContentView' expected to be an instance of a class or class-constrained type

核心触发逻辑非常明确：

• SwiftUI 的 ContentView 是 结构体（struct），属于值类型；而你定义的 showPopover(sender:) 参数类型是 AnyObject，这个类型仅接受引用类型的类实例，结构体无法被传入，因此触发类型错误。
• 另外你直接在 ContentView 内声明 var statusBar: StatusBarController? 的写法也有问题：SwiftUI 的 View 是值类型，每次视图重绘都会重新生成结构体实例，这个属性根本持久持有不了控制器实例，运行时大概率为nil，按钮点了也不会有反应。

1. 调整StatusBarController的方法定义 #

你代码里的sender参数实际上根本没有被用到，不需要强限制为AnyObject类型，改成兼容任意类型、带默认值的可选参数即可，同时修正代码里的selector方法名笔误：

class StatusBarController {
    private var popover: NSPopover
    private var statusBar: NSStatusBar
    private var statusItem: NSStatusItem
    private var eventMonitor: EventMonitor?
    
    init(_ popover: NSPopover)
    {
        self.popover = popover
        statusBar = NSStatusBar.init()
        statusItem = statusBar.statusItem(withLength: 28.0)
        
        if let statusBarButton = statusItem.button {
            statusBarButton.image = #imageLiteral(resourceName: "StatusBarIcon")
            statusBarButton.image?.size = NSSize(width: 18.0, height: 18.0)
            statusBarButton.image?.isTemplate = true
            // 修正原代码笔误：selector方法名和实际实现对齐
            statusBarButton.action = #selector(showPopover(sender:))
            statusBarButton.target = self
        }
        
        eventMonitor = EventMonitor(mask: [.leftMouseDown, .rightMouseDown], handler: mouseEventHandler)
    }
    
    // 参数改成Any? 加默认值nil，兼容OC selector和SwiftUI调用场景
    @objc func showPopover(sender: Any? = nil) {
        if(popover.isShown) {
            hidePopover(sender)
        }
        else {
            displayPopover()
        }
    }

    func displayPopover() {
        if let statusBarButton = statusItem.button {
            popover.show(relativeTo: statusBarButton.bounds, of: statusBarButton, preferredEdge: NSRectEdge.maxY)
            eventMonitor?.start()
        }
    }
    
    // 同步修改hidePopover的参数类型
    func hidePopover(_ sender: Any? = nil) {
        popover.performClose(sender)
        eventMonitor?.stop()
    }

    func mouseEventHandler(_ event: NSEvent?) {
        if(popover.isShown) {
            hidePopover(event)
        }
    }
}

2. 在App入口持久持有状态栏控制器 #

不要把控制器实例存在ContentView里，要在App的入口结构体里持有，保证应用生命周期内不会被释放：

@main
struct YourMenuBarApp: App {
    private let popover = NSPopover()
    private var statusBarController: StatusBarController?
    
    init() {
        // 先初始化控制器
        let controller = StatusBarController(popover)
        self.statusBarController = controller
        
        // 配置popover，把控制器实例传入ContentView
        popover.contentSize = NSSize(width: 360, height: 240)
        popover.behavior = .transient // 点击弹窗外部自动关闭，按需配置
        popover.contentViewController = NSHostingController(
            rootView: ContentView(statusBar: controller)
        )
    }
    
    var body: some Scene {
        // 菜单栏应用不需要主窗口，留空即可
        EmptyScene()
    }
}

3. 调整ContentView的代码 #

把statusBar改成let常量接收传入的控制器实例，按钮调用方法时不需要传self：

struct ContentView: View {
    let statusBar: StatusBarController
    
    var body: some View {
        Button("Show/Hide Popover"){
            // 直接调用即可，参数用默认值nil
            statusBar.showPopover()
        }
        .padding()
    }
}

• 不要在SwiftUI的View结构体里定义长期持有的对象属性，值类型的生命周期和视图重绘绑定，会导致持有的对象被意外释放。
• Selector绑定的方法要加@objc标记，方法名要和#selector里的名称完全一致，否则点菜单栏图标会无响应。
• 如果你的应用用的是AppDelegate生命周期，把StatusBarController的持有逻辑放在AppDelegate里即可，逻辑和上面的App入口写法一致。

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