开发工具构建工具【免费下载链接】wix3WiX Toolset v3.x项目地址https://gitcode.com/gh_mirrors/wi/wix3点击查看免费下载WiX Toolsetv3.x为 Visual Studio 提供了完整的 WiX 项目支持Votive开发者可以在 IDE 中直接创建.wixproj项目、编写.wxs源码并完成编译与链接。本文以 votive_property_pages.html.md 为骨架系统讲解 WiX 项目五大属性页Installer、Build、Build Events、Paths、Tool Settings中每一个配置项的用途与取值并结合仓库中的 MSBuild 实现wix.targets、Light.cs剖析每个选项最终如何转化为 candle、lit、light 的命令行行为。读完本文你将能像配置一个普通 C# 项目一样精确控制 WiX 安装包工程的构建行为。如何打开 WiX 项目属性页在 Visual Studio 的解决方案资源管理器Solution Explorer中右键单击 WiX 项目即扩展名为.wixproj的项目在上下文菜单中选择Properties属性即可打开 WiX 项目属性页。与 C#、VB 等项目一致WiX 属性页同样区分配置Debug / Release与平台AnyCPU、x86、x64 等不同配置下可以保存各自独立的设置。WiX 项目共包含以下五个属性页Installer安装程序Build生成Build Events生成事件Paths路径Tool Settings工具设置Installer 属性页输出名称与输出类型Installer 标签页只负责两项最基础的产出设置Output name一个文本框指定构建过程最终生成文件的名称不含扩展名。在底层 MSBuild 中它对应OutputName属性并进一步推导为TargetName、TargetFileName、TargetPath等一系列宏见 wix.targets 第 230 行附近TargetName Condition $(TargetName) $(OutputName)/TargetName。Output type一个下拉列表用于选择输出类型MSI 包Package扩展名.msi合并模块Module扩展名.msmWiX 库Library扩展名.wixlib引导程序Bundle扩展名.exe从仓库源码看MSBuild 层还额外支持PatchCreation.pcp补丁创建文件这一输出类型wix.targets 第 194–199 行按OutputType为每种类型分配了目标扩展名TargetExt Condition $(OutputType) Package .msi/TargetExt TargetExt Condition $(OutputType) Module .msm/TargetExt TargetExt Condition $(OutputType) PatchCreation .pcp/TargetExt TargetExt Condition $(OutputType) Library .wixlib/TargetExt TargetExt Condition $(OutputType) Bundle .exe/TargetExt同时 _CheckRequiredProperties 目标会校验若OutputType未设置则默认按Package处理若取值非法则报错 WIXTARGETS102OutputName为空则报错 WIXTARGETS100。仓库中的集成测试工程 SimpleMsi.wixproj 就是一个最小示例PropertyGroup ProductVersion3.9/ProductVersion ProjectGuid{822B8D17-3932-43E5-B410-22A5257995FA}/ProjectGuid OutputNameSimpleMsi/OutputName OutputTypePackage/OutputType DefineSolutionPropertiesfalse/DefineSolutionProperties SuppressValidationtrue/SuppressValidation /PropertyGroupBuild 属性页常量、多语言、消息与输出控制Build 标签页包含三个分区是日常构建调优的主要入口。General常规分区该分区允许你定义配置相关的常量即向编译器candle.exe传入的预处理器变量。底层对应DefineConstants属性wix.targets 在Compile目标中将其与解决方案、项目和项目引用级常量合并后传给 Candle 任务第 2036–2037 行DefineConstants$(DefineConstants);$(SolutionDefineConstants);$(ProjectDefineConstants);$(ProjectReferenceDefineConstants)。仓库自身的 WixBuild.wixproj.props 就是一个典型例子它把WixBundleCompressed、VS2010Available等变量注入到DefineConstants中。指定要构建的区域性culture即“Cultures to build”设置。它与命令行中light.exe -cultures:的语义一致详见 Specifying cultures to build。关键语法是多个区域性用分号分隔表示构建多个产物组内用逗号分隔表示回退fallback链例如en-US,en;en-GB,en上述配置会构建 en-US 与 en-GB 两个 MSIlight 会先在第一个区域性en-US/en-GB中查找本地化变量找不到再回退到en。中性区域性用neutral表示。该语义在 wix.targets 的AssignCultures目标第 2270–2349 行中有明确注释并由WixAssignCulture任务负责把Cultures属性解析成(CultureGroup)列表——每个文化组对应一个输出子目录和一次 light 调用。Messages消息分区该分区用于控制构建输出的消息行为警告级别warning levels可以指定要抑制的警告或整体警告策略。从源码结构看这些设置会被映射为SuppressAllWarnings/SuppressSpecificWarnings/Pedantic等属性并分别派发给 Harvestheat、Compilercandle、Liblit、Linkerlight任务wix.targets 第 310–411 行。将警告视为错误treat warnings as errors对应TreatWarningsAsErrors/TreatSpecificWarningsAsErrors同样按工具分别以CompilerTreatWarningsAsErrors、LinkerTreatWarningsAsErrors、LibTreatWarningsAsErrors的形式传入对应任务。详细输出verbose output对应VerboseOutput如LinkerVerboseOutput会向 candle / lit / light 追加详细日志开关。Output输出分区该分区控制构建产物的去向与中间文件行为输出路径output path对应OutputPath属性并进一步初始化OutDir、TargetDir、TargetPath等宏。wix.targets 第 117–124 行会为OutputPath补充尾部反斜杠并在未显式指定时默认bin\Debug\。删除临时文件delete temporary files控制链接后是否清理临时文件。底层对应LeaveTemporaryFiles属性Light 任务在 Light.cs 第 481 行通过commandLineBuilder.AppendIfTrue(-notidy, this.LeaveTemporaryFiles)把它转换成 light.exe 的-notidy开关。抑制 wixpdb 输出suppress the wixpdb file对应SuppressPdbOutputLight 任务将其映射为-spdb开关Light.cs 第 494 行并在输出组中跳过 PDB 产物wix.targets 第 2945 行的Condition $(SuppressPdbOutput) ! true 。将文件绑定进库文件bind files into the library file仅当工程为WiX Library输出类型为 Library时可用。对应BindFiles属性在Lib目标中以LibBindFiles传给 lit-bf开关在Link目标中以LinkerBindFiles传给 light。Build Events 属性页构建前后钩子Build Events 标签页包含Pre-build event command line在构建当前项目之前执行的命令行。Post-build event command line在构建当前项目之后执行的命令行。Run the post-build event一个下拉组合框指定后置生成事件在何种条件下执行。其执行时机由 wix.targets 中的PreBuildEvent第 760–782 行与PostBuildEvent第 2815–2838 行目标驱动CoreBuild目标的依赖链为...PreBuildEvent → ResolveReferences → CompileAndLink → ... → PostBuildEvent。RunPostBuildEvent支持四种取值注释见第 2799–2805 行取值行为OnBuildSuccess或留空仅当构建每一步都成功时才执行后置事件OnOutputUpdated仅当主输出确实被更新重新生成时才执行底层通过比较_TimeStampBeforeCompileAndLink与_TimeStampAfterCompileAndLink两个时间戳判断Always无条件执行后置事件即使构建失败也执行两个事件的命令文本中可以使用宏其中!(TargetPath)与!(TargetPdbPath)会在执行前由ReplaceString任务替换为实际路径见PreBuildEvent目标第 765–779 行与PostBuildEvent目标第 2821–2835 行。Edit Pre-build...与Edit Post-build...按钮会弹出编辑对话框对话框中列出了所有可用的 WiX 项目引用变量及其基于当前工程设置的值。这些变量既包括工程自身的宏Configuration、OutDir、Platform、ProjectDir、ProjectFileName、ProjectName、ProjectPath、TargetDir、TargetExt、TargetFileName、TargetName、TargetPath见 wix.targets 第 438–452 行的ProjectDefineConstants定义也包括项目引用变量与解决方案变量例如$(var.MyProject.TargetPath)、$(var.MyProject.TargetFileName)、$(var.SolutionDir)、$(var.SolutionName)等——完整的变量清单与示例值可参考 votive_project_references.html.md。典型的用法是把项目引用变量写进 WiX 源码例如File IdMyExecutable Name$(var.MyProject.TargetFileName) Source$(var.MyProject.TargetPath) DiskId1 /Paths 属性页引用路径与包含路径Paths 标签页包含两个分区Reference Paths引用路径定义用于定位引用WiX 扩展程序集与 WiX 库的搜索路径。从 wix.targets 的ResolveWixExtensionReferences目标第 715–748 行可以清晰看到查找顺序(1) $(ReferencePaths) —— 即本属性页中配置的引用路径 (2) {HintPathFromItem} —— 引用项自身携带的 HintPath (3) {RawFileName} —— 把引用的名称当作真实文件名 (4) $(WixExtDir) —— WiX 工具安装目录Include Paths包含路径定义用于定位WiX Include 文件.wxi的搜索路径。底层对应IncludeSearchPaths属性在Compile目标中作为IncludeSearchPaths$(IncludeSearchPaths)传给 Candle 任务wix.targets 第 2044 行。仓库自身的构建也依赖该机制——WixBuild.wixproj.props 第 30 行就追加了$(IncludeSearchPaths);$(BuiltIncludePath);$(WixRoot)\src\ext\ca\inc;$(WixVersionPath)把扩展共享的 include 目录暴露给编译器。Tool Settings 属性页ICE 校验与透传参数Tool Settings 标签页包含两个分区ICE validationICE 校验分区ICEInternal Consistency Evaluator内部一致性评估器是 Windows Installer 数据库的验证规则在链接阶段由 light.exe 执行。该分区允许你抑制 ICE 校验suppress ICE validation对应SuppressValidation属性Light 任务将其转换为-sval开关Light.cs 第 500 行。注意这会跳过所有ICE 校验通常仅用于验证流程的临时调试。指定要抑制的特定 ICEsuppress specific ICE validation对应SuppressIces属性转换为-sice:开关Light.cs 第 488 行可精确屏蔽某几条 ICE例如-sice:ICE01;ICE02。对应的反方向能力是Ices属性 →-ice:开关第 479 行用于在默认校验之外追加执行额外的自定义 ICE此外AdditionalCub→-cub开关可用于指定包含自定义 ICE 的.cub文件。从 wix.targets 第 2462–2490 行的Link目标可以看到Ices、SuppressIces、SuppressValidation、SuppressPdbOutput、SuppressLayout、SuppressIntermediateFileVersionMatching等属性全部被传入Light任务最终在 Light.cs 的BuildCommandLine中组装成 light.exe 命令行。Additional parameters附加参数分区该分区允许你直接把命令行参数透传给构建时的 WiX 工具。底层对应三组属性CompilerAdditionalOptions—— 透传给candle.exewix.targets 第 2036 行LibAdditionalOptions—— 透传给lit.exe第 2247 行LinkerAdditionalOptions—— 透传给light.exe第 2442 行Light 任务通过commandLineBuilder.AppendTextIfNotNull(this.AdditionalOptions)Light.cs 第 507 行把附加文本原样追加到命令行末尾。这是实现代码签名、自定义压缩级别、指定绑定输入路径等高级场景的“逃生舱”——凡是属性页没有单独列出的工具开关都可以通过这里直接传入。从属性页到底层命令行一条完整的映射链把上述内容串起来可以看到 WiX 属性页本质上是对 MSBuild 属性的图形化封装而 MSBuild 属性最终通过任务Task转换成工具命令行属性页选项 → MSBuild 属性例如 Output name →OutputNameOutput type →OutputTypeCultures →CulturesICE 抑制 →SuppressIces/SuppressValidation。MSBuild 属性 → 任务参数wix.targets 中的CompileCandle、LibLit、LinkLight目标负责把属性赋值给对应任务的参数例如SuppressIces$(SuppressIces)、Cultures%(CultureGroup.Identity)。任务参数 → 工具开关以 Light 为例Light.cs 的BuildCommandLine把SuppressIces写成-sice:、SuppressValidation写成-sval、BindFiles写成-bf、LeaveTemporaryFiles写成-notidy、SuppressPdbOutput写成-spdb。值得注意的底层细节还包括CompileAndLink目标wix.targets 第 1265–1283 行把整个构建组织为ResolveReferences → Harvest → Compile → Lib → Link的流水线属性页中的大部分选项只影响Compile/Lib/Link这三个环节。多区域性工程会为每个CultureGroup生成独立的TargetPath输出到TargetDirculture\子目录TargetPath因此可能包含多个以分号分隔的路径见AssignCultures目标第 2316–2342 行。WiX 工具是 32 位进程当 MSBuild 运行在非 32 位环境时会以独立进程方式运行RunWixToolsOutOfProc第 89–92 行Additional parameters中的参数不受影响。实用建议与常见误区多语言工程用 Cultures 而非多工程在 Build 页的 Cultures 字段里使用en-US,en;fr-FR,fr这样的文化组语法即可一次构建多个本地化 MSI并共享en/fr回退资源开发阶段可临时只保留一个区域性以加快构建详见 Specifying cultures to build。慎用“抑制所有 ICE 校验”SuppressValidation-sval会跳过全部内部一致性校验可能导致产物在真实系统上出现序列、注册表或权限问题。若只需绕过个别规则优先使用“指定要抑制的 ICE”-sice:精确屏蔽。构建事件中的变量带!()与$()两套语法事件编辑对话框中列出的是$(var.ProjectName.X)这类项目引用/解决方案变量而!(TargetPath)、!(TargetPdbPath)是构建系统在执行前动态替换的特殊宏。混用时要区分二者的替换时机。Library 工程的 BindFiles 只在打包库时才有意义如果工程输出类型不是 WiX LibraryBuild 页中的“bind files into the library”选项不会生效。延伸阅读Working in Visual StudioVotive 总览了解 WiX 项目类型、项模板与创建安装包的基本流程。Using Project References and Variables构建事件对话框中出现的全部项目引用变量与解决方案变量清单。Item TemplatesWiX 项目可用的.wxs、.wxi、.wxl项模板。wix.targets本文所有选项的 MSBuild 底层实现是属性页与命令行之间最权威的映射参考。Light.cslight.exe 任务把 MSBuild 参数组装成命令行的完整开关表。SimpleMsi.wixproj一个最小可构建的集成测试工程可直接对照属性页的 XML 形态。赞分享开发工具构建工具【免费下载链接】wix3WiX Toolset v3.x项目地址https://gitcode.com/gh_mirrors/wi/wix3点击查看免费下载相关推荐WiX Toolset v3 的 Visual Studio 项目模板从 WiX Project、WiX Library 到 Merge ModuleWiX Toolset v3 的 Visual Studio 项目模板从 WiX Project、WiX Library 到 Merge Module WiX开发工具构建工具WiX Toolset 项模板Item Templates完全指南在 Visual Studio 中快速创建 .wxs、.wxi、.wxl 文件WiX Toolset 项模板Item Templates完全指南在 Visual Studio 中快速创建 .wxs、.wxi、.wxl 文件 WiX开发工具构建工具CMake CPack WIX Generator 完全指南用 WiX Toolset 构建 Windows Installer.msi安装包CMake CPack WIX Generator 完全指南用 WiX Toolset 构建 Windows Installer.msi安装包 导读 本文构建工具开发工具CLI上一篇如何高效解决Palworld存档转换问题完整解决方案指南下一篇终极浏览器广告拦截指南如何用uBlock Origin高效保护你的网络隐私创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考