MacOS UIElement应用菜单栏打开窗口随机显示问题求助

问题根源 #

UIElement类型的应用默认处于非活跃状态（无Dock图标、不抢占系统菜单栏），直接调用makeKeyAndOrderFront时，系统会因为应用未激活，将窗口置于当前活跃应用的窗口之下，导致显示随机，同时触发日志中的警告。

解决方案 #

1. 激活应用后再显示窗口

修改AppDelegate中的openSettingsWindow方法，先激活应用再将窗口前置，确保窗口能正确显示在最上层：

@objc func openSettingsWindow() {
    if settingsWindow == nil {
        let settingsView = SettingsView()
        settingsWindow = NSWindow(
            contentRect: NSRect(x: 20, y: 20, width: 480, height: 300),
            styleMask: [.titled, .closable, .miniaturizable, .resizable, .fullSizeContentView],
            backing: .buffered,
            defer: false
        )
        settingsWindow.center()
        settingsWindow.title = "Settings"
        settingsWindow.isReleasedWhenClosed = false
        settingsWindow.contentView = NSHostingView(rootView: settingsView)
    }
    // 强制激活应用，确保窗口能前置
    NSApp.activate(ignoringOtherApps: true)
    settingsWindow.makeKeyAndOrderFront(nil)
}

2. 修正AppDelegate实例引用

在applicationDidFinishLaunching中初始化instance属性，确保能直接访问Delegate实例：

func applicationDidFinishLaunching(_ notification: Notification) {
    AppDelegate.instance = self // 新增此行，初始化单例引用
    statusBarItem.button?.image = NSImage(
        systemSymbolName: "circle",
        accessibilityDescription: "My App"
    )
    statusBarItem.menu = menu.createMenu()
}

3. 简化菜单动作绑定

直接将菜单选项的target指向AppDelegate实例，避免间接调用的不确定性：
修改AppMenu的createMenu方法：

func createMenu() -> NSMenu {
    // ...
    let settingsMenuItem = NSMenuItem(title: "Settings", action: #selector(AppDelegate.openSettingsWindow), keyEquivalent: ",")
    settingsMenuItem.target = AppDelegate.instance // 直接绑定到Delegate实例
    menu.addItem(settingsMenuItem)
    // ...
    return menu
}

同时可以删除AppMenu中的settings中转方法，无需再通过NSApp.sendAction触发窗口打开。

4. 移除冲突的SwiftUI Settings Scene

原代码中MyApp的body里声明的Settings Scene会让系统自动创建一个设置窗口，和你手动创建的settingsWindow产生冲突，直接移除并替换为隐藏的空场景：

@main
struct MyApp: App {
    @NSApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some Scene {
        WindowGroup {
            EmptyView()
        }
        .hidden() // 隐藏默认窗口，符合UIElement应用需求
    }
}

额外说明 #

• 确保Info.plist中已设置LSUIElement为YES，这是UIElement应用的核心配置，确保应用不在Dock中显示。
• 使用NSApp.activate(ignoringOtherApps: true)可以强制激活应用，彻底解决窗口被其他应用遮挡的问题。

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