主版本号为0的WiX生成包升级问题求助

这问题我之前帮团队处理过，确实挺棘手——旧包已经部署在数千台设备上，总不能让用户手动卸载，也不想用生硬的自定义msiexec /x命令对吧？其实不用绕远路，我们可以直接绕过WiX对版本≥1.0的限制，用Windows Installer原生的Upgrade表来实现干净的自动升级，下面是具体方案：

核心思路：手动定义Upgrade表，绕过WiX的版本过滤 #

WiX的<MajorUpgrade>元素为了简化操作，默认会过滤掉主版本号小于1的包，这就是WIX_UPGRADE_DETECTED没被填充的原因。我们可以放弃使用<MajorUpgrade>，直接手动配置Upgrade表条目，让Windows Installer识别并处理0.x版本的旧包。

步骤1：确保新旧包共享相同的UpgradeCode #

首先要确认你的旧包和新包使用完全相同的UpgradeCode——这是Windows Installer识别同系列产品的核心标识，没有这个前提，升级逻辑根本找不到旧包。如果旧包是用WiX生成的，你可以在旧包的WiX源码里找到这个GUID，直接复制到新包中：

<Product Id="*" UpgradeCode="YOUR_SHARED_UPGRADE_CODE_GUID" Version="NEW_VERSION" ...>

（新包的ProductId设为*让WiX自动生成新的GUID，这是Major Upgrade的要求）

步骤2：手动添加Upgrade和UpgradeVersion元素 #

在新包的WiX源码里，添加以下配置来匹配所有低于新版本的旧包（包括0.x系列）：

<Upgrade Id="YOUR_SHARED_UPGRADE_CODE_GUID">
  <!-- 匹配所有版本低于当前新版本的旧包 -->
  <UpgradeVersion
     Minimum="0.0.0"
     Maximum="NEW_VERSION"
     IncludeMinimum="yes"
     IncludeMaximum="no"
     Property="OLD_PRODUCTS_FOUND"
     MigrateFeatures="yes" />
</Upgrade>

• Property：用来存储找到的旧包ProductCode列表（多个旧包会用分号分隔）
• MigrateFeatures="yes"：让Windows Installer自动迁移旧包的特性状态（比如用户之前选择安装的组件，新包会保留相同的选择）

步骤3：安排RemoveExistingProducts执行顺序 #

接下来要在安装序列里指定何时卸载旧包，推荐放在InstallInitialize之后、InstallFiles之前，这样卸载和安装在同一个事务里，万一安装失败会自动回滚：

<InstallExecuteSequence>
  <RemoveExistingProducts After="InstallInitialize" />
</InstallExecuteSequence>

额外场景：如果旧包没有统一的UpgradeCode？ #

如果你的旧包因为某些原因没有使用固定的UpgradeCode（这种情况比较少见），可以直接指定旧包的ProductCode来匹配：

<Upgrade>
  <!-- 匹配特定旧版本的ProductCode -->
  <UpgradeVersion
     ProductCode="OLD_PACKAGE_PRODUCT_CODE_GUID"
     Property="OLD_PRODUCT_FOUND" />
  <!-- 如果有多个旧版本，添加多个UpgradeVersion条目 -->
  <UpgradeVersion
     ProductCode="ANOTHER_OLD_PRODUCT_CODE_GUID"
     Property="OLD_PRODUCT_FOUND" />
</Upgrade>

不过这种方式需要你收集所有已部署旧包的ProductCode，维护起来比较麻烦，优先推荐用UpgradeCode的方案。

为什么这比自定义msiexec /x更优？ #

• 原生可靠：这是Windows Installer内置的升级逻辑，比自定义动作更稳定，能自动处理事务回滚、权限管理等问题
• 特性迁移：MigrateFeatures参数可以保留用户的安装配置，不用重新设置
• 日志可追溯：安装日志会清晰记录旧包检测、卸载的全过程，方便排查问题

测试建议 #

在正式部署前，一定要在安装了旧包的测试机上验证：

1. 运行新包的安装程序，观察旧包是否自动卸载
2. 查看安装日志（用msiexec /i new_package.msi /l*v install.log生成），确认OLD_PRODUCTS_FOUND被正确填充，RemoveExistingProducts动作正常执行

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