如何在Swift开发的macOS App中设置不同的程序坞图标

方法一：运行时动态替换程序坞图标 #

这是最直接的方案，通过Swift代码在应用启动后替换程序坞显示的图标，不影响应用本身的主图标（比如访达里显示的图标）。

• 把你制作的程序坞专用图标（比如命名为DockIcon.icns）添加到Xcode项目的资源文件中，确保勾选了对应的target。
• 在应用启动后的合适位置执行替换代码，比如在AppDelegate的applicationDidFinishLaunching方法里：

import Cocoa

@main
class AppDelegate: NSObject, NSApplicationDelegate {
    func applicationDidFinishLaunching(_ aNotification: Notification) {
        // 替换程序坞图标
        if let dockIconPath = Bundle.main.path(forResource: "DockIcon", ofType: "icns"),
           let dockIcon = NSImage(contentsOfFile: dockIconPath) {
            NSApp.setApplicationIconImage(dockIcon)
        }
    }
}

• 注意事项：
  • 如果用户之前手动修改过该应用的程序坞图标，系统会保留自定义设置，需要让用户右键点击程序坞图标 -> 选项 -> 从程序坞移除，然后重新打开应用才能生效。
  • 确保DockIcon.icns符合Apple HIG的图标规格，包含不同分辨率的版本（如16x16、32x32、128x128、256x256、512x512、1024x1024）。

方法二：利用系统备用图标机制（可选） #

如果希望保留图标切换能力，同时默认启动时用程序坞专用图标，可以通过Info.plist配置实现：

1. 在Info.plist中添加备用图标定义：

<key>CFBundleAlternateIcons</key>
<dict>
    <key>DockIcon</key>
    <dict>
        <key>CFBundleIconFiles</key>
        <array>
            <string>DockIcon</string>
        </array>
        <key>UIPrerenderedIcon</key>
        <false/>
    </dict>
</dict>

2. 在启动代码中切换到该备用图标：

if NSApp.setAlternateIconName("DockIcon", completionHandler: { error in
    if let error = error {
        print("切换图标失败：\(error.localizedDescription)")
    }
}) {
    // 切换成功
}

这个方法由系统管理图标缓存，但如果只是需要默认替换程序坞图标，方法一更简洁。

验证与测试 #

编译运行应用后，检查程序坞显示的图标是否替换成功。如果没生效，先确认图标文件是否正确加入项目、路径是否正确，再尝试重置程序坞的自定义图标设置。

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