如何阻止Wix v3 Bundle同时运行多个实例？

方案一：使用Wix Util扩展的Mutex元素（推荐） #

这是Wix官方原生支持的单实例控制方案，无需外部脚本或额外代码，完全集成在Bundle配置中，适配成品部署场景。

实施步骤：

1. 添加Wix Util扩展引用：在你的Wix Bundle项目中，添加对WixUtilExtension.dll的引用（文件通常位于Wix安装目录的bin文件夹下）。
2. 声明命名空间：在Bundle的XML根节点中加入util命名空间：

   <Bundle xmlns="http://schemas.microsoft.com/wix/2006/wi"
           xmlns:util="http://schemas.microsoft.com/wix/UtilExtension">
   

3. 配置全局互斥体：在Bundle节点下插入Mutex元素，设置唯一标识：

   <!-- 全局互斥体，跨用户会话阻止多实例启动 -->
   <util:Mutex Id="MyAppBundleMutex" 
               Name="Global\MyCompany_MyProduct_BundleMutex" 
               Wait="yes" 
               Timeout="30000" />
   

   • Name：必须全局唯一，建议用公司名+产品名组合命名，前缀Global\确保多用户环境下也能检测到已有实例。
   • Wait：设为yes时，新实例会等待已有实例结束（最长等待Timeout毫秒）；设为no时直接阻止新实例启动。
   • Timeout：等待超时时间，单位毫秒（示例为30秒）。

自定义阻止提示（可选）

若设置Wait="no"，可配合LaunchCondition弹出友好提示：

<util:Mutex Id="MyAppBundleMutex" 
            Name="Global\MyCompany_MyProduct_BundleMutex" 
            Wait="no" />
<LaunchCondition Condition="NOT Mutex_Exists_MyAppBundleMutex" 
                 Message="已有一个安装程序实例正在运行，请关闭后重试。" />

检测到已有实例时，安装程序会立即弹出提示并退出。

方案二：自定义Burn引导程序应用（进阶） #

如果需要更复杂的控制逻辑（比如定制弹窗、进程优先级处理），可以自定义Burn引导程序应用：

1. 继承BootstrapperApplication类
2. 启动时通过Windows API检测同名进程（或基于Bundle唯一标识）
3. 检测到已有实例时直接退出并提示用户

此方案需编写C++/C#代码，适合有深度定制需求的场景，普通场景下方案一已足够简洁可靠。

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