macOS 开发 - 创建 SwiftUI + AppKit 状态栏应用(popover视图)

1
2
3
4
5
6
7
8
9
10
import SwiftUI

@main
struct StatusBarDemoApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
import SwiftUI
import AppKit

@main
struct StatusBarDemoApp: App {
    @NSApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    
    var body: some Scene {
        Settings {
            EmptyView() // 防止自动生成主窗口
        }
    }
}

final class AppDelegate: NSObject, NSApplicationDelegate {
    func applicationDidFinishLaunching(_ notification: Notification) {
        // 设置为辅助应用（不显示 Dock 图标）
        NSApp.setActivationPolicy(.accessory)
        
        print("✅ 状态栏应用启动成功")
        // 这里我们稍后会添加状态栏初始化代码
    }
    
    func applicationWillTerminate(_ notification: Notification) {
        print("📱 应用即将退出")
        // 这里我们稍后会添加清理代码
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
import AppKit
import SwiftUI

class StatusBarController {
    // 单例模式
    static let shared = StatusBarController()
    
    private var statusItem: NSStatusItem?
    
    private init() {}
    
    /// 设置状态栏图标
    func setupStatusBar() {
        // 创建状态栏项目
        statusItem = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
        
        // 确保成功创建
        guard let statusButton = statusItem?.button else {
            print("❌ 无法创建状态栏按钮")
            return
        }
        
        // 设置图标（使用系统图标）
        statusButton.image = NSImage(systemSymbolName: "star.fill", accessibilityDescription: "状态栏应用")
        
        // 设置点击事件
        statusButton.action = #selector(statusBarClicked)
        statusButton.target = self
        
        print("✅ 状态栏图标创建成功")
    }
    
    /// 状态栏图标点击事件
    @objc private func statusBarClicked() {
        print("🖱️ 状态栏图标被点击了！")
    }
    
    /// 清理状态栏
    func cleanup() {
        if let statusItem = statusItem {
            NSStatusBar.system.removeStatusItem(statusItem)
            print("🧹 状态栏已清理")
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
final class AppDelegate: NSObject, NSApplicationDelegate {
    
    func applicationDidFinishLaunching(_ notification: Notification) {
        // 设置为辅助应用（不显示 Dock 图标）
        NSApp.setActivationPolicy(.accessory)
        
        // 初始化状态栏
        StatusBarController.shared.setupStatusBar()
        
        print("✅ 状态栏应用启动成功")
    }
    
    func applicationWillTerminate(_ notification: Notification) {
        // 清理资源
        StatusBarController.shared.cleanup()
        print("📱 应用即将退出")
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
import SwiftUI

struct StatusBarPopView: View {
    @State private var counter = 0
    @State private var message = "欢迎使用状态栏应用！"
    
    var body: some View {
        VStack(spacing: 16) {
            // 标题区域
            headerView
            
            Divider()
            
            // 主要内容
            mainContent
            
            Divider()
            
            // 操作按钮
            actionButtons
        }
        .padding(20)
        .frame(width: 300)
        .background(.regularMaterial, in: RoundedRectangle(cornerRadius: 12))
    }
    
    // 标题视图
    private var headerView: some View {
        HStack {
            Image(systemName: "star.fill")
                .foregroundColor(.orange)
                .font(.title2)
            
            Text("我的状态栏应用")
                .font(.headline)
                .fontWeight(.medium)
            
            Spacer()
            
            Text("v1.0")
                .font(.caption)
                .foregroundColor(.secondary)
        }
    }
    
    // 主要内容区域
    private var mainContent: some View {
        VStack(spacing: 12) {
            Text(message)
                .font(.body)
                .multilineTextAlignment(.center)
                .foregroundColor(.primary)
            
            // 计数器
            HStack(spacing: 16) {
                Button(action: {
                    counter -= 1
                    updateMessage()
                }) {
                    Image(systemName: "minus.circle.fill")
                        .font(.title2)
                        .foregroundColor(.red)
                }
                .buttonStyle(.plain)
                
                Text("\(counter)")
                    .font(.title)
                    .fontWeight(.bold)
                    .monospacedDigit()
                    .frame(minWidth: 60)
                
                Button(action: {
                    counter += 1
                    updateMessage()
                }) {
                    Image(systemName: "plus.circle.fill")
                        .font(.title2)
                        .foregroundColor(.green)
                }
                .buttonStyle(.plain)
            }
            .padding()
            .background(.background.secondary, in: RoundedRectangle(cornerRadius: 8))
        }
    }
    
    // 操作按钮区域
    private var actionButtons: some View {
        HStack(spacing: 12) {
            Button("重置") {
                withAnimation(.spring()) {
                    counter = 0
                    message = "计数器已重置"
                }
            }
            .buttonStyle(.bordered)
            
            Spacer()
            
            Button("退出应用") {
                NSApp.terminate(nil)
            }
            .buttonStyle(.bordered)
            .foregroundColor(.red)
        }
    }
    
    // 更新消息
    private func updateMessage() {
        withAnimation(.easeInOut(duration: 0.3)) {
            if counter == 0 {
                message = "开始计数吧！"
            } else if counter > 0 {
                message = "很好！当前计数: \(counter)"
            } else {
                message = "负数了，要不要重置？"
            }
        }
    }
}

// 预览
#Preview {
    StatusBarPopView()
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
import AppKit
import SwiftUI

class StatusBarController {
    static let shared = StatusBarController()
    
    private var statusItem: NSStatusItem?
    private var popover: NSPopover?
    
    private init() {}
    
    func setupStatusBar() {
        // 创建状态栏项目
        statusItem = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
        
        guard let statusButton = statusItem?.button else {
            print("❌ 无法创建状态栏按钮")
            return
        }
        
        // 设置图标
        statusButton.image = NSImage(systemSymbolName: "star.fill", accessibilityDescription: "状态栏应用")
        statusButton.action = #selector(togglePopover)
        statusButton.target = self
        
        print("✅ 状态栏图标创建成功")
    }
    
    @objc private func togglePopover() {
        guard let statusButton = statusItem?.button else { return }
        
        if let popover = popover, popover.isShown {
            // 如果 popover 已显示，则隐藏
            hidePopover()
        } else {
            // 显示 popover
            showPopover(relativeTo: statusButton)
        }
    }
    
    private func showPopover(relativeTo button: NSStatusBarButton) {
        // 创建 popover
        let newPopover = NSPopover()
        newPopover.behavior = .transient  // 点击外部自动关闭
        newPopover.animates = true
        newPopover.contentSize = NSSize(width: 300, height: 280)
        
        // 设置 SwiftUI 内容
        let contentView = StatusBarPopView()
        newPopover.contentViewController = NSHostingController(rootView: contentView)
        
        self.popover = newPopover
        
        // 显示 popover
        newPopover.show(relativeTo: button.bounds, of: button, preferredEdge: .minY)
        
        print("✅ Popover 显示成功")
    }
    
    private func hidePopover() {
        popover?.performClose(nil)
        popover = nil
        print("📦 Popover 已隐藏")
    }
    
    func cleanup() {
        hidePopover()
        if let statusItem = statusItem {
            NSStatusBar.system.removeStatusItem(statusItem)
            print("🧹 状态栏已清理")
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
private func showPopover(relativeTo button: NSStatusBarButton) {
    // ... 前面的 popover 创建代码保持不变 ...
    
    // 显示 popover
    newPopover.show(relativeTo: button.bounds, of: button, preferredEdge: .minY)
    
    // 🔥 关键配置：确保在全屏模式下正确显示
    configurePopoverWindow(newPopover)
    
    print("✅ Popover 显示成功")
}

/// 配置 popover 窗口属性
private func configurePopoverWindow(_ popover: NSPopover) {
    guard let window = popover.contentViewController?.view.window else {
        print("⚠️ 无法获取 popover 窗口")
        return
    }
    
    // 设置窗口层级为状态栏级别
    window.level = .statusBar
    
    // 设置窗口行为：允许在所有空间显示，支持全屏辅助
    window.collectionBehavior = [.moveToActiveSpace, .fullScreenAuxiliary]
    
    // 窗口关闭时不释放
    window.isReleasedWhenClosed = false
    
    // 激活应用以确保获得焦点
    NSApp.activate(ignoringOtherApps: true)
    
    print("🔧 Popover 窗口配置完成")
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
class StatusBarController {
    // ... 前面的属性定义 ...
    private var eventMonitors: [Any] = []  // 🆕 存储事件监听器
    
    // ... 前面的 setupStatusBar、togglePopover 等方法保持不变 ...
    
    // 在 showPopover 方法中调用 setupEventMonitors()
    private func showPopover(relativeTo button: NSStatusBarButton) {
        // ... popover 创建和显示代码 ...
        
        // 配置窗口属性
        configurePopoverWindow(newPopover)
        
        // 🆕 设置事件监听
        setupEventMonitors()
    }
    
    /// 设置事件监听器
    private func setupEventMonitors() {
        // ESC 键关闭 popover
        let localMonitor = NSEvent.addLocalMonitorForEvents(matching: .keyDown) { [weak self] event in
            if event.keyCode == 53 { // ESC 键
                self?.hidePopover()
                return nil
            }
            return event
        }
        
        // 点击外部关闭 popover
        let globalMonitor = NSEvent.addGlobalMonitorForEvents(matching: [.leftMouseDown, .rightMouseDown]) { [weak self] _ in
            self?.hidePopover()
        }
        
        // 保存监听器引用
        if let localMonitor = localMonitor {
            eventMonitors.append(localMonitor)
        }
        if let globalMonitor = globalMonitor {
            eventMonitors.append(globalMonitor)
        }
        
        print("🎧 事件监听器设置完成")
    }
    
    // 更新 hidePopover 方法
    private func hidePopover() {
        popover?.performClose(nil)
        popover = nil
        
        // 🧹 清理事件监听器
        eventMonitors.forEach { NSEvent.removeMonitor($0) }
        eventMonitors.removeAll()
        
        print("📦 Popover 已隐藏，监听器已清理")
    }
}

1
2
3
4
5
StatusBarDemo/
├── StatusBarDemoApp.swift          # 应用主入口
├── StatusBarController.swift       # 状态栏控制器
├── StatusBarPopView.swift          # Popover 内容视图
└── ContentView.swift              # 默认视图（未使用）

1
@AppStorage("counterValue") private var counter = 0

1
NSApp.setActivationPolicy(.accessory)

1
2
3
4
5
// 使用项目中的图片
statusButton.image = NSImage(named: "custom-icon")

// 或者使用 SF Symbols
statusButton.image = NSImage(systemSymbolName: "your-symbol-name", accessibilityDescription: nil)