Wix标准引导程序应用：如何在安装页面添加复选框以选装服务

核心思路 #

Wix Standard BA本身不直接支持在Install页面添加自定义复选框，但可以通过自定义Wix Standard BA的XAML UI结合Bundle变量控制功能状态来实现，无需依赖过时的Extended BA。

具体实现步骤 #

1. 提取并修改默认Standard BA的XAML布局

   • 找到Wix安装目录下的Standard BA主题文件（通常在%WIX%\\src\\ext\\BalExtension\\wixstdba\\Resources路径，比如HyperlinkTheme.xaml或RtfTheme.xaml）。
   • 复制该文件到你的项目中，在Install页面的布局区域添加复选框控件，示例代码：

     <CheckBox x:Name="InstallServiceCheckBox" Content="安装附加服务" IsChecked="True" Margin="10,0,0,0"/>
     

2. 编写自定义Bootstrapper Application类

   • 新建C#类库项目，引用WixToolset.Bal.wixext和WixToolset.Dtf.WindowsInstaller。
   • 继承WixStandardBootstrapperApplication，通过代码绑定复选框状态到Bundle变量：

     public class CustomBootstrapperApplication : WixStandardBootstrapperApplication
     {
         protected override void OnStartup(StartupEventArgs e)
         {
             base.OnStartup(e);
             var serviceCheckBox = this.Window.FindName("InstallServiceCheckBox") as CheckBox;
             if (serviceCheckBox != null)
             {
                 serviceCheckBox.Checked += (sender, args) => 
                     this.Engine.SetVariable("INSTALL_SERVICE", "1");
                 serviceCheckBox.Unchecked += (sender, args) => 
                     this.Engine.SetVariable("INSTALL_SERVICE", "0");
             }
         }
     }
     

3. 在Bundle中配置变量与安装条件

   • 在Bundle项目里注册自定义BA，定义控制变量，并通过变量控制服务安装包的启用状态：

     <Bundle>
         <BootstrapperApplicationRef Id="WixStandardBootstrapperApplication.HyperlinkTheme">
             <Payload SourceFile="..\CustomBA\bin\Debug\CustomBA.dll"/>
             <Payload SourceFile="..\CustomBA\bin\Debug\CustomBA.pdb"/>
             <WixStandardBootstrapperApplication ThemeFile="CustomHyperlinkTheme.xaml" />
         </BootstrapperApplicationRef>
     
         <Variable Name="INSTALL_SERVICE" Type="numeric" Value="1" />
     
         <!-- 用变量控制服务MSI的安装条件 -->
         <MsiPackage SourceFile="ServiceSetup.msi" DisplayName="附加服务"
                     InstallCondition="INSTALL_SERVICE = 1" />
     </Bundle>
     

4. 编译测试

   • 编译自定义BA项目和Bundle项目，确保Payload路径指向正确的编译产物。
   • 运行生成的引导程序，验证Install页面的复选框是否能正确控制对应服务的安装状态。

注意事项 #

• 自定义XAML时要保持原有主题的布局逻辑，避免破坏默认页面的交互流程。
• 确保自定义BA的版本与使用的Wix工具集版本一致，避免兼容性问题。
• 测试时覆盖复选框勾选、取消两种场景，确认服务安装/跳过的行为符合预期。

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