Wails应用在macOS上隐藏Dock图标的解决方案

问题背景

在使用Wails框架开发macOS应用时，开发者可能会遇到一个常见问题：即使设置了StartHidden: true和调用了wailsRunTime.Hide(ctx)方法，应用程序图标仍然会出现在Dock栏中。这种情况通常发生在需要开发后台服务或状态栏应用时，开发者希望应用完全隐藏而不出现在Dock中。

技术原理分析

macOS应用程序的显示行为由NSApplication的激活策略(Activation Policy)控制。系统提供了三种不同的激活策略：

1. 常规应用(Regular)：标准GUI应用，会显示在Dock中
2. 辅助应用(Accessory)：不会显示在Dock中，但可以接收键盘输入
3. 禁止交互(Prohibited)：完全后台运行，不与用户交互

Wails默认使用常规应用策略，因此即使用户隐藏了主窗口，应用图标仍会出现在Dock中。

解决方案实现

要完全隐藏Wails应用在Dock中的图标，需要通过Objective-C桥接修改应用的激活策略。以下是具体实现方法：

1. 创建一个专门处理macOS特定功能的Go文件，添加构建标签确保只在macOS平台编译：

//go:build darwin

package main

/*
#cgo CFLAGS: -x objective-c
#cgo LDFLAGS: -framework Cocoa
#import <Cocoa/Cocoa.h>

int SetActivationPolicy() {
    [NSApp setActivationPolicy:NSApplicationActivationPolicyAccessory];
    return 0;
}
*/
import "C"

func setDockHidden() {
    C.SetActivationPolicy()
}

2. 在应用启动时调用此函数：

func (a *App) startup(ctx context.Context) {
    // 其他初始化代码...
    setDockHidden()
}

注意事项

1. 使用辅助应用策略后，应用将不会出现在Dock中，但仍可通过状态栏菜单或全局快捷键与用户交互。

2. 如果需要完全隐藏应用(不显示任何界面元素)，可以使用NSApplicationActivationPolicyProhibited策略，但这样应用将无法接收任何用户输入。

3. 修改激活策略应在应用启动早期进行，最好在OnStartup回调中执行。

4. 此解决方案仅适用于macOS平台，其他操作系统需要不同的实现方式。

替代方案探讨

除了直接修改激活策略，开发者还可以考虑以下替代方案：

1. 使用状态栏应用模式：将应用完全转换为状态栏应用，这种方式在macOS上更为常见。

2. 使用Wails的Tray功能：通过系统托盘图标提供用户交互入口，同时保持主窗口隐藏。

3. 结合两种策略：在需要时动态切换激活策略，提供更灵活的用户体验。

总结

通过理解macOS应用激活策略的工作原理，Wails开发者可以有效地控制应用在Dock中的显示行为。虽然Wails框架本身没有直接提供隐藏Dock图标的功能，但通过简单的平台特定代码实现，开发者可以轻松实现这一需求。这种解决方案特别适合需要开发后台服务、状态栏应用或完全无界面应用的场景。