如何在Eclipse Maven/Tycho Product中正确配置图标解决IconExe报错

根因说明 #

这个报错不是Maven/Tycho本身的缺陷，是你配置Windows平台启动器图标的格式不符合p2打包工具要求导致的：
Windows系统的可执行文件（.exe）内嵌图标使用的是ICO容器格式，该格式可同时包含多种尺寸、色深的图标条目。Equinox p2提供的IconExe工具逻辑是读取你提供的ICO文件里的对应条目，替换launcher.exe中原生的内置图标，你使用独立BMP文件配置的方式无法被工具正确识别匹配，因此出现指定尺寸图标未替换的报错。

解决步骤 #

• 第一步：将你现有的7个符合尺寸、色深要求的BMP文件合并为单个ICO格式文件，确保生成的ICO文件包含报错中提到的所有尺寸（16×16、32×32、48×48、256×256）的32位色深图标条目，你可以用任意常用的图标编辑工具完成合并操作。
• 第二步：修改.product文件中的Windows平台图标配置，删除原来配置的多个BMP图标条目，替换为单ICO文件的配置，参考示例如下：

<launcher name="你的产品启动器名称">
  <!-- Windows平台专用ICO图标配置 -->
  <icon icon="resources/icons/你的产品图标.ico" os="win32"/>
  <!-- 其他平台（macOS、Linux）的原有图标配置无需修改，可继续保留原格式配置 -->
</launcher>

• 第三步：清理本地Maven构建缓存和之前的构建产出，重新执行Tycho构建即可消除该报错。

异常排查 #

如果替换为ICO后仍有同类报错，检查你生成的ICO文件是否缺了报错中指定的尺寸/色深的图标条目，补全对应条目后重新构建即可。

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