咨询：基于CMake的Qt6跨平台（Windows/Mac/Linux）可执行文件图标设置方法

以下是针对Windows、macOS、Linux（通用桌面环境）的平台专属配置方案，均基于CMake构建系统：

Windows #

• 图标要求：准备包含多尺寸（16x16、32x32、48x48、256x256等）的.ico格式文件，覆盖不同显示场景。
• CMake配置：

  if(WIN32)
      # 替换为你的图标文件路径
      set(APP_ICON "${CMAKE_CURRENT_SOURCE_DIR}/resources/app_icon.ico")
      # 将目标标记为GUI应用（避免弹出控制台窗口）
      set_property(TARGET YourAppTarget PROPERTY WIN32_EXECUTABLE TRUE)
      # 将图标文件加入编译资源
      target_sources(YourAppTarget PRIVATE ${APP_ICON})
  endif()
  

  编译后生成的.exe文件会直接带有设置的图标，无需额外步骤。

macOS #

• 图标要求：准备.icns格式文件，需包含多分辨率图标（16x16到1024x1024），可通过Icon Composer或第三方工具从PNG生成。
• CMake配置：

  if(APPLE)
      # 替换为你的icns文件路径
      set(APP_ICON "${CMAKE_CURRENT_SOURCE_DIR}/resources/app_icon.icns")
      # 配置macOS Bundle包属性
      set_target_properties(YourAppTarget PROPERTIES
          MACOSX_BUNDLE TRUE
          # 指定Bundle内的图标文件名
          MACOSX_BUNDLE_ICON_FILE app_icon.icns
      )
      # 标记图标文件的打包位置（Resources目录）
      set_source_files_properties(${APP_ICON} PROPERTIES
          MACOSX_PACKAGE_LOCATION "Resources"
      )
      # 将图标加入目标源文件
      target_sources(YourAppTarget PRIVATE ${APP_ICON})
  endif()
  

  编译后生成的.app包会显示设置的图标，双击启动时的Dock图标也会同步生效。

Linux #

Linux桌面环境依赖图标主题和.desktop启动器文件，需按标准目录结构部署：

1. 图标准备：提供多尺寸.png文件（16x16、32x32、48x48、128x128、256x256），统一命名为your_app.png。
2. CMake配置（含安装规则）：

   if(UNIX AND NOT APPLE)
       # 安装图标到系统hicolor主题目录（通用兼容所有桌面环境）
       install(FILES resources/app_icon_16.png DESTINATION share/icons/hicolor/16x16/apps RENAME your_app.png)
       install(FILES resources/app_icon_32.png DESTINATION share/icons/hicolor/32x32/apps RENAME your_app.png)
       install(FILES resources/app_icon_48.png DESTINATION share/icons/hicolor/48x48/apps RENAME your_app.png)
       install(FILES resources/app_icon_128.png DESTINATION share/icons/hicolor/128x128/apps RENAME your_app.png)
       install(FILES resources/app_icon_256.png DESTINATION share/icons/hicolor/256x256/apps RENAME your_app.png)
   
       # 生成.desktop启动器文件
       configure_file(
           ${CMAKE_CURRENT_SOURCE_DIR}/your_app.desktop.in
           ${CMAKE_CURRENT_BINARY_DIR}/your_app.desktop
           @ONLY
       )
       install(FILES ${CMAKE_CURRENT_BINARY_DIR}/your_app.desktop DESTINATION share/applications)
   endif()
   

3. .desktop模板文件（your_app.desktop.in）：

   [Desktop Entry]
   Type=Application
   Name=你的应用名称
   Exec=@CMAKE_INSTALL_PREFIX@/bin/YourAppTarget
   Icon=your_app
   Comment=你的应用描述
   Categories=Utility;Development; # 根据应用类型调整分类
   

• 本地测试：若不想安装到系统，可将图标放到~/.local/share/icons/hicolor/对应尺寸/apps/，.desktop文件放到~/.local/share/applications/，然后执行update-desktop-database ~/.local/share/applications/刷新桌面缓存。

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