如何为Xcode开发的C++命令行工具设置应用图标？

针对你用XCode 13.2.1在macOS 12.2上开发的wxWidgets GUI命令行工具图标空白的问题，按以下步骤排查修复：

1. 确认AppIcon的格式和尺寸合规 #

• macOS应用图标需覆盖多尺寸（16x16、32x32、64x64、128x128、256x256、512x512、1024x1024像素），且每个常规尺寸要有对应的@2x Retina版本
• 确保所有图标为PNG格式且无损坏，完整填充到XCode的Images.xcassets>AppIcon对应尺寸槽位，不要只放单个大尺寸图标

2. 检查XCode项目配置 #

• 打开项目Build Settings，搜索Asset Catalog Compiler - Options，确认Primary App Icon Set Name设置为AppIcon（与你的图标集名称一致）
• 查看Info.plist文件，确认存在CFBundleIcons配置：
  该字典需包含CFBundlePrimaryIcon，其下CFBundleIconName值为AppIcon，避免旧的图标路径配置冲突

3. 适配wxWidgets框架的图标加载逻辑 #

因为是wxWidgets开发，需确保框架正确识别图标：

• 在wxApp的OnInit()方法中添加图标加载代码：

bool MyApp::OnInit()
{
    wxIcon appIcon;
    // 路径对应XCode打包后的资源位置，或直接引用生成的icns文件
    if (appIcon.LoadFile("AppIcon.icns", wxBITMAP_TYPE_ICNS))
    {
        SetIcon(appIcon);
    }
    // 其他初始化代码...
    return true;
}

• 若用Asset Catalog仍不生效，可手动生成icns文件：
  用iconutil命令将多尺寸PNG打包为icns：

  iconutil -c icns your_icon_folder.iconset
  

  将生成的your_icon.icns添加到XCode项目，并确保在Build Phases>Copy Bundle Resources中包含该文件

4. 清理缓存并重新构建 #

• 清理XCode项目：点击菜单栏Product>Clean Build Folder（快捷键Cmd+Shift+K）
• 删除Derived Data：XCode>Preferences>Locations>Derived Data，打开文件夹后删除对应项目的缓存
• 重启XCode后重新构建运行，若Dock图标仍空白，右键图标>选项>从Dock移除，重启应用后再添加

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