在 Windows 安装包开发领域，WiX Toolset（Windows Installer XML）一直以其灵活性和强大功能深受开发者青睐。尤其是 WiX 的 Bundle 技术——即通过 Burn 引擎创建的引导程序包——能够将多个 MSI、EXE 或补丁包打包成一个统一的安装体验。然而，在实际开发中，一个常见且棘手的问题是：在 Bundle 层面，如何正确判断当前执行的是安装操作还是卸载操作？ 这一问题直接关系到 UI 逻辑、条件判断、自定义操作以及日志记录等关键环节。本文将为您详细解析这一技术要点。

背景：为什么需要区分安装与卸载？

WiX Bundle 通常用于承载复杂的软件套件，例如一个包含主程序、驱动、运行时库的安装包。当用户双击 Bundle 时，Burn 引擎会根据系统状态自动决定执行安装、卸载、修改或修复操作。但在某些场景下，开发者需要在代码层面主动感知当前动作，以执行不同的流程。例如：

  • 在卸载时清理用户数据，但在安装时写入配置；
  • 在安装时显示欢迎界面，在卸载时显示确认对话框；
  • 根据操作类型决定是否注册 COM 组件或服务。

因此，准确判断“Install”或“Uninstall”是构建健壮 Bundle 的第一步。

核心方法：利用 BAL（Bootstrapper Application Logic）中的变量

WiX 的 Burn 引擎通过“引导程序应用程序”（Bootstrapper Application，通常为 BA）与用户交互。标准 BA（如 WixStandardBootstrapperApplication）内置了一系列预定义变量，其中最关键的是 WixBundleAction。该变量在 Bundle 运行的整个生命周期内可用，其值为一个整数枚举，代表当前操作类型。具体对应关系如下：

  • 1：Install（安装）
  • 2：Uninstall（卸载）
  • 3：Maintenance（维护/修复）
  • 4：Modify（修改，如添加或移除功能，仅在先安装后出现）

因此，开发者只需在 BA 代码或 WiX 源文件中的条件表达式中引用 WixBundleAction 即可区分。

示例（WiX 源文件中的条件用法）：

<Variable Name="IsUninstall" Type="numeric" Value="0" Persisted="false"/>
<SetVariable Variable="IsUninstall" Value="1" Condition="WixBundleAction = 2"/>
<!-- 后续可根据IsUninstall控制UI或链式包 -->

高级技巧：在自定义 BA 中处理

对于编写自定义 BA（C# 或 C++）的开发者，原理类似。Burn 引擎通过 IBootstrapperEngine::GetVariableNumeric 方法暴露了 WixBundleAction 变量。在 .NET 托管 BA 中，可以这样获取：

int action;
engine.GetVariableNumeric("WixBundleAction", out action);
if (action == 2)
{
    // 卸载逻辑
}

值得注意的是，WixBundleAction 的值在 检测阶段（Detect Phase） 之后即已确定，因此在 OnDetectComplete 或后续事件中均可安全读取。

实战陷阱与最佳实践

1. 区分“已安装”与“首次安装”

即使 WixBundleAction 为 1（安装），也可能是因为 Bundle 此前已安装但处于损坏状态导致的重装。若要判断是否为全新安装，可结合检查 WixBundleInstalled 变量：该变量在 Bundle 已安装时为 1，否则为 0。

2. 正确处理“修复”与“修改”

修复（Maintenance）和修改（Modify）在用户通过控制面板启动 Bundle 时出现。如果您的卸载逻辑依赖于清除所有文件，需特别注意：在修复模式下不应执行完全卸载操作，否则会导致组件丢失。建议仅当 WixBundleAction == 2 时才执行彻底卸载。

3. 日志与调试

在执行 WixBundleAction 判断时，建议将动作值写入日志以便调试。WiX 内置日志级别较高，您只需在 BA 启动时添加 -log log.txt 参数即可。

实际案例：一个混合安装场景

某安全软件使用 WiX Bundle 打包了引擎、驱动和UI界面。在卸载时，需要保留用户配置文件（用于下次安装时恢复），但必须删除驱动服务。通过以下条件实现：

<Condition Variable="IsUninstall" Value="1">WixBundleAction = 2</Condition>
<Condition Variable="KeepUserData" Value="1">WixBundleAction = 2</Condition>

然后在每个 MSI 包的 slipstream 或自定义操作中引用这些变量，成功实现精细化流程控制。

展望未来

随着 WiX v5 的逐步成熟，Burn 引擎引入了更多高级特性，包括更完善的变量系统和可扩展性。但 WixBundleAction 作为基础判别变量，其核心地位不会改变。对于正在迁移或新建项目的团队，掌握这一方法将极大提升安装包的兼容性与用户体验。

总之，“如何判断 Install 还是 Uninstall”虽是小问题，却是构建专业级 Windows 安装程序不可忽视的基石。合理利用 WixBundleAction，您的 WiX Bundle 将更具智能与鲁棒性。