从InstallShield迁移到WiX v4 Bundle后小版本升级失效求助

问题根源分析 #

你的配置存在两处核心问题：

1. MSI的升级检测范围包含了当前版本，导致逻辑冲突
2. Bundle的<RelatedBundle>未指定版本筛选规则，引导程序无法识别需要升级的旧版本

具体修正步骤 #

1. 修正MSI项目（Product.wxs） #

调整升级检测范围

将<UpgradeVersion>的IncludeMaximum设为no，避免当前版本被误判为需要移除的旧版本：

<Upgrade Id="$(var.UpgradeCode)">
    <UpgradeVersion Minimum="$(var.InitialVersion)"
                    Maximum="$(var.ProductVersion)"
                    Property="PREVIOUSVERSIONSINSTALLED"
                    IncludeMinimum="yes"
                    IncludeMaximum="no" /> <!-- 修改此处为no -->
</Upgrade>

确认ProductCode规则

小版本升级时必须保持ProductCode不变，只有主版本变更时才修改ProductCode。如果你的$(var.ProductCode)在小版本迭代中自动生成了新值，需要调整变量配置，固定ProductCode直到主版本升级。

2. 修正Bundle项目（Bundle.wxs） #

完善RelatedBundle版本筛选

给<RelatedBundle>添加版本范围，明确指定要升级的旧版本区间：

<RelatedBundle Id="{01F40945-4195-4FBE-886C-2F1137F21D6B}"
               Action="Upgrade"
               MinimumVersion="x.y.0.0" <!-- 替换为你的初始测试版本 -->
               MaximumVersion="$(var.ProductVersion)"
               IncludeMinimum="yes"
               IncludeMaximum="no" />

如果需要兼容所有低于当前版本的旧Bundle，可以把MinimumVersion设为产品的最早版本（比如1.0.0.0），只要UpgradeCode一致，就能自动匹配所有旧版本。

固定Bundle的UpgradeCode

小版本升级时不要修改Bundle的UpgradeCode，这个值需要和所有同主版本的Bundle保持一致，只有主版本变更时才考虑更换。

额外注意事项 #

• 组件更新：如果MSI中的组件内容有修改，要确保组件的Version属性递增，或者保证KeyPath正确，避免MSI跳过组件更新。
• 测试流程：先验证单独安装新版本正常，再测试从旧版本升级的流程，排除基础安装问题的干扰。
• 日志排查：如果升级仍有问题，可通过msiexec /i your.msi /l*v install.log和Bundle的burn.log查看具体错误信息，定位问题。

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