使用WiX制作安装包：如何检测特定旧版本范围以执行自定义操作

问题背景 #

我正在使用WiX编写安装程序，目前仅处理重大升级，相关代码如下：

<Product Id="*" UpgradeCode="SOME-GUID">
  <Package Id="*">
    <MajorUpgrade DowngradeErrorMessage="A later version of [ProductName] is already installed."/>

我计划在下一版本中添加自定义操作，但希望仅在从特定版本范围升级时执行该操作。查看升级的详细日志后发现，FindRelatedProducts会设置WIX_UPGRADE_DETECTED和MIGRATE属性，它们对应旧版本安装的产品GUID，请问是否有办法获取旧版本的版本号？

可行实现方法 #

方法一：使用WiX内置的WixQueryRelatedProducts自定义操作 #

WiX自带了专门用于查询相关产品版本的自定义操作，无需额外编写代码：

• 首先定义存储旧版本号的属性：

<Property Id="OLD_PRODUCT_VERSION" Secure="yes" />

• 配置查询所需的属性，指定你的UpgradeCode和目标版本范围：

<Property Id="WIX_QUERY_UPGRADE_CODE" Value="SOME-GUID" />
<!-- 按需设置版本范围，比如只查询1.0.0.0到2.0.0.0之间的旧版本 -->
<Property Id="WIX_QUERY_MIN_VERSION" Value="1.0.0.0" />
<Property Id="WIX_QUERY_MAX_VERSION" Value="2.0.0.0" />

• 添加自定义操作并插入到安装序列中：

<CustomAction Id="QueryOldVersion" BinaryKey="WixCA" DllEntry="WixQueryRelatedProducts" Return="check" />
<InstallExecuteSequence>
  <!-- 在FindRelatedProducts之前执行查询 -->
  <Custom Action="QueryOldVersion" Before="FindRelatedProducts">NOT Installed</Custom>
</InstallExecuteSequence>

当检测到符合版本范围的旧产品时，OLD_PRODUCT_VERSION属性会被自动填充为旧版本的版本号，后续可通过条件判断决定是否执行你的自定义操作。

方法二：编写自定义操作调用MSI API查询 #

如果需要更灵活的逻辑，可以自己编写自定义操作（支持C++、C#等语言），通过MSI提供的API查询产品版本：

• C++示例：使用MsiGetProductInfo函数查询

#include <Windows.h>
#include <Msi.h>

UINT __stdcall GetOldVersion(MSIHANDLE hInstall) {
    WCHAR szProductCode[39] = {0};
    DWORD dwBufSize = 39;
    UINT uiStatus = MsiGetProperty(hInstall, L"WIX_UPGRADE_DETECTED", szProductCode, &dwBufSize);
    if (uiStatus == ERROR_SUCCESS && wcslen(szProductCode) > 0) {
        WCHAR szVersion[256] = {0};
        dwBufSize = 256;
        uiStatus = MsiGetProductInfo(szProductCode, INSTALLPROPERTY_VERSIONSTRING, szVersion, &dwBufSize);
        if (uiStatus == ERROR_SUCCESS) {
            MsiSetProperty(hInstall, L"OLD_PRODUCT_VERSION", szVersion);
        }
    }
    return ERROR_SUCCESS;
}

• C#示例（使用WiX DTF）：

using Microsoft.Deployment.WindowsInstaller;

public class CustomActions {
    [CustomAction]
    public static ActionResult GetOldVersion(Session session) {
        string oldProductCode = session["WIX_UPGRADE_DETECTED"];
        if (!string.IsNullOrEmpty(oldProductCode)) {
            string oldVersion = ProductInstallation.GetProductInfo(oldProductCode, "VersionString");
            session["OLD_PRODUCT_VERSION"] = oldVersion;
        }
        return ActionResult.Success;
    }
}

编译自定义操作后，将其添加到WiX项目中，并在安装序列中FindRelatedProducts之后执行，再通过OLD_PRODUCT_VERSION属性的值判断是否触发目标自定义操作。

方法三：旧版本预配置属性传递（仅适用于未发布的旧版本） #

如果旧版本还未发布，可以在旧版本的WiX代码中添加一个自定义属性，将版本号存入其中：

<Property Id="OLD_VERSION" Value="[ProductVersion]" Secure="yes" />

在新版本的MajorUpgrade配置中启用属性迁移，旧版本的OLD_VERSION属性会被传递到新版本的安装会话中。但这种方法对已发布的旧版本无效，仅适合提前规划的场景。

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