使用WiX Toolset时，如何避免.exe程序经.msi升级后ARP出现重复条目？

这个问题我之前帮不少开发者排查过，本质是你的.exe引导程序和.msi升级包在ARP（添加/删除程序）中的产品标识没对齐导致的。下面是几个关键的解决步骤，按顺序检查基本能搞定：

• 确保核心标识的一致性
  WiX里的UpgradeCode是Windows Installer识别同一产品家族的核心，所有版本的安装包（包括.exe引导的初始安装和后续.msi升级）必须使用完全相同的UpgradeCode。而ProductCode则需要在每次版本升级（主/次版本号变更时）生成新的GUID，但绝对不能改动UpgradeCode。另外注意ProductVersion必须严格遵循X.X.X.X的格式，前三位是Windows Installer识别版本升级的关键，第四位不会影响升级逻辑。

• 让.msi全权管理ARP条目
  如果你的.exe是用WiX Burn制作的引导程序，一定要在Bundle元素中设置DisableARP="yes"，这样引导程序本身不会在ARP里生成独立条目，所有ARP相关的注册都交给.msi处理。要是你的.exe是其他工具生成的，得检查它是否自行注册了ARP条目——如果是，必须禁用这个行为，避免和.msi的条目重复。

• 正确配置Upgrade元素实现无缝替换
  在WiX的Product元素下添加Upgrade元素，指定你的UpgradeCode，让安装程序自动识别并替换旧版本，而不是并行安装。示例配置如下：

  <Upgrade Id="YOUR-UNIQUE-UPGRADE-GUID">
    <UpgradeVersion Minimum="1.0.0.0" Maximum="2.0.0.0" 
                    Property="OLDVERSIONFOUND"
                    IncludeMinimum="yes" IncludeMaximum="no" />
  </Upgrade>
  

  同时要在InstallExecuteSequence中添加RemoveExistingProducts动作，控制旧版本的移除时机（推荐放在InstallInitialize之后或InstallFinalize之前，根据你的安装流程调整），确保旧版本被完全替换而不是共存。

• 统一ARP显示属性
  所有版本的.msi中，DisplayName、Publisher这些ARP显示属性必须完全一致。比如不能一个版本叫"我的应用v1.0"，另一个叫"我的应用程序v2.0"，应该统一命名为"我的应用"，版本号由Windows Installer自动在ARP中显示，避免被识别为不同产品。

• 验证ARP相关属性设置
  检查.msi中是否误设了ARPSYSTEMCOMPONENT="yes"（除非你需要把它作为系统组件隐藏），同时ARPHELPLINK、ARPURLINFOABOUT这些可选属性也要保持一致，避免混淆Windows Installer的产品识别逻辑。

如果按上述步骤调整后还有问题，可以用Orca工具打开新旧版本的安装包，对比ProductCode、UpgradeCode以及ARP相关属性，找出不一致的地方。

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