如何为Qt应用的macOS Dock图标菜单添加新选项

Qt本身没有直接提供配置macOS Dock菜单的组件，但可以通过**Objective-C++**桥接macOS原生Cocoa API实现自定义Dock菜单的需求，具体步骤如下：

实现思路 #

Qt在macOS平台基于Cocoa框架运行，因此可以直接调用Cocoa的NSApplication、NSMenu等API修改Dock右键菜单，同时通过Objective-C++实现Qt信号槽与原生API的交互。

1. 创建Objective-C++处理文件 #

新建DockMenuHelper.mm文件，实现Dock菜单的自定义逻辑：

#include <Cocoa/Cocoa.h>
#include <QtCore/QObject>

@interface DockMenuHelper : NSObject
+ (void)setupCustomDockMenuWithTarget:(QObject*)target selector:(SEL)selector;
@end

@implementation DockMenuHelper
+ (void)setupCustomDockMenuWithTarget:(QObject*)target selector:(SEL)selector {
    NSApplication *app = [NSApplication sharedApplication];
    NSMenu *dockMenu = [app dockMenu];
    
    // 添加分隔符
    [dockMenu addItem:[NSMenuItem separatorItem]];
    
    // 创建自定义菜单项
    NSMenuItem *customItem = [[NSMenuItem alloc] initWithTitle:@"我的自定义操作" action:selector keyEquivalent:@""];
    [customItem setTarget:(id)target];
    [dockMenu addItem:customItem];
    [customItem release];
}
@end

2. 在Qt代码中调用并绑定槽函数 #

在Qt窗口类（如MainWindow）中调用上述方法，将自定义菜单项的点击事件绑定到Qt槽函数：

#include <QMainWindow>
#include <QDebug>

// 声明Objective-C++方法
@interface DockMenuHelper : NSObject
+ (void)setupCustomDockMenuWithTarget:(QObject*)target selector:(SEL)selector;
@end

class MainWindow : public QMainWindow
{
    Q_OBJECT
public:
    MainWindow(QWidget *parent = nullptr) : QMainWindow(parent) {
        // 应用启动后初始化Dock菜单
        [DockMenuHelper setupCustomDockMenuWithTarget:this selector:@selector(onCustomDockItemClicked:)];
    }

public slots:
    void onCustomDockItemClicked(id sender) {
        // 处理自定义菜单项点击逻辑
        qDebug() << "自定义Dock菜单项被触发";
    }
};

3. 配置Qt项目文件 #

修改.pro文件，确保编译器能正确编译Objective-C++代码并链接Cocoa框架：

OBJECTIVE_SOURCES += DockMenuHelper.mm
LIBS += -framework Cocoa

注意事项 #

• 建议在应用窗口初始化完成后再调用Dock菜单设置方法，避免菜单未加载完成导致的异常。
• 槽函数的签名需与Objective-C选择器匹配，若不需要 sender 参数，可调整为void onCustomDockItemClicked()。
• 如需添加子菜单、图标等更复杂的菜单结构，可直接使用Cocoa的NSMenu相关API扩展实现。

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