WiX Toolset 3.11中BootstrapperApplicationRef未解析问题解决

• 触发第一类编译报错：

  未解析的符号引用 'WixBootstrapperApplication:WixStandardBootstrapperApplication.RtfLicense'
  本质是项目未显式引用对应功能的WiX扩展：该内置UI的实现位于WixBalExtension程序集中，WiX 3.8之后就不再自动加载所有内置扩展，缺少项目引用时就会触发符号未解析报错，和3.11与3.6的版本功能差异无直接关系。

• 后续触发的连锁报错：

  未解析的符号引用 'WixBootstrapperApplication:WixNetFxExtension'
  是参考老教程修改时引入的问题：老教程默认会在项目中引入.NET环境前置检测扩展，但同样需要在项目层面添加对应引用，否则无论是否保留BootstrapperApplicationRef元素，都会触发符号查找失败的报错。

• 切换项目类型后触发的编译报错：

  系统找不到文件 'DLS8Setup.8.5.1.exe'
  只要为ExePackage配置了SourceFile属性，WiX编译器在编译阶段就会强制校验该本地文件是否存在、是否可读，不会自动识别配置了DownloadUrl就跳过本地校验——这是WiX的固定编译逻辑，不存在“编译器本应等运行时再找文件”的特殊判定。

• 配置占位文件后生成的安装程序无UI，是因为调整项目配置的过程中丢失了WixBalExtension的引用，BootstrapperApplicationRef无法匹配到实际的UI实现，最终加载了无界面的原生bootstrapper核心。

• 补全项目引用：在WiX Bundle项目中添加WixBalExtension引用，即可解决所有Bootstrapper UI相关的未解析报错；如果不需要.NET前置检测逻辑，删除参考教程里所有涉及WixNetFxExtension的代码，无需额外添加该扩展的引用。
• 调整下载类安装包的配置，跳过编译期本地文件校验：删除ExePackage上的本地SourceFile属性，保持下载地址配置，加上Compressed="no"标记，参考写法：

<ExePackage 
  Id="DymoLabelSoftware"
  DownloadUrl="http://download.dymo.com/dymo/Software/Win/DLS8Setup.8.5.1.exe"
  Compressed="no"
  InstallCommand="/qn"
  DetectCondition="DymoLabelSoftwareIsInstalled">
</ExePackage>

• 校验BootstrapperApplicationRef配置：保持Id="WixStandardBootstrapperApplication.RtfLicense"的原始配置，确认扩展引用加载正常后，编译生成的程序就会正常弹出许可协议界面，再按照预设流程执行下载、安装操作。

• 照搬WiX 3.6时期的老教程时，必须注意WiX 3.8之后的扩展加载规则，所有用到的内置功能都要手动在项目引用中添加对应扩展，否则必然触发未解析符号报错。
• 所有需要运行时下载的外部安装包，只要写了本地SourceFile路径，编译器就会强制校验文件存在性，无法通过纯配置跳过，必须删除本地路径声明，完全靠下载地址配置拉取资源。
• 生成的安装包双击无界面时，优先检查WixBalExtension的引用状态，确认BootstrapperApplicationRef的Id和已加载的扩展实现匹配，不要修改为无UI的内置启动项。

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