VS2022利用WiX Toolset打包winform程序安装包（1）

Deccc.

已于 2023-09-24 08:39:07 修改

阅读量1.5k

点赞数 1

分类专栏： VS2022 WiXToolset 文章标签： windows visual studio c# .net

于 2023-09-18 19:27:44 首次发布

本文链接：https://blog.csdn.net/weixin_45921305/article/details/132969818

版权

VS2022 同时被 2 个专栏收录

10 篇文章 1 订阅

订阅专栏

WiXToolset

5 篇文章 0 订阅

订阅专栏

《安装WiX Toolset与简单打包程序》

以下是我自己结合各资料的实操步骤笔记。

工具：visual studio 2022 / WiX Toolset / winform项目

一、安装Wix Toolset

下载【WiX v3 - Visual Studio 2022 Extension】的步骤

二、扩展安装

三、创建项目

四、修改Product.wxs配置信息

下载Wix Toolset Build Tools的步骤

参考资料

一、安装Wix Toolset

WiX v3 | WiX Toolset

（tip：当时下载的是【WiX v3 - Visual Studio 2022 Extension】，后面到最后生成时报错了，原因是上面的【Download WiX v3.11.2】没有下载）

避免踩坑：这一步骤应该下载的是【Download WiX v3.11.2】，详细步骤查看【下载Wix Toolset Build Tools的步骤】

下载【WiX v3 - Visual Studio 2022 Extension】的步骤

（1）进入安装向导，选择【install】，下载期间需要关闭visual studio所有打开的文件；

（2）等待安装；

（3）安装完成，重启visual studio。

二、扩展安装

1.打开VS，选择【扩展】——【管理扩展】，搜索并安装下载这两个扩展，然后关闭VS，等待更新完成；

三、创建项目

1.以WindowsForm项目为例；

2.解决方案右键，【添加】——【新建项目】；

3.查找wix，选择【Setup Project for WiX v3】，这种是打包成msi格式，点击【下一步】；

4.新建完成后就会出现以下结构，鼠标移至【References】，右键，【添加引用】；

5.引入要打包的项目，【添加】，然后【确定】；

此时添加完成后如下图：

四、修改Product.wxs配置信息

1.Manufacturer为控制面板程序里的发布者，Name为程序名称，修改【Manufacturer】中内容；

<Product Id="*" Name="wixSetupProject1" Language="1033" Version="1.0.0.0" Manufacturer="WixDemo" UpgradeCode="79fce79f-caaa-44c7-96c6-62a689665404">

2.添加以下这段代码；

3.配置代码示例；

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
	<Product Id="*" Name="wixSetupProject1" Language="1033" Version="1.0.0.0" Manufacturer="WixDemo" UpgradeCode="79fce79f-caaa-44c7-96c6-62a689665404">
		<Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />

		<MajorUpgrade DowngradeErrorMessage="A newer version of [ProductName] is already installed." />
		<MediaTemplate />
		
		<!-- 安装清单 -->
		<Feature Id="ProductFeature" Title="wixSetupProject1" Level="1">
			<ComponentGroupRef Id="ProductComponents" />
		</Feature>
	</Product>

	<Fragment>
		<!-- 文件安装路径 -->
		<Directory Id="TARGETDIR" Name="SourceDir">
			<Directory Id="ProgramFilesFolder">
				<Directory Id="INSTALLFOLDER" Name="wixSetupProject1" /> 
			</Directory>
		</Directory>

	</Fragment>

	<Fragment>
		<ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER">
			<!-- TODO: Remove the comments around this Component element and the ComponentRef below in order to add resources to this installer. -->
			<!-- <Component Id="ProductComponent"> -->
				<!-- TODO: Insert files, registry keys, and other resources here. -->
			<!-- </Component> -->
						
		<Component Id="ProductComponent">
        <File Source="$(var.WindowsForms1.TargetPath)" /> <!--引用中的项目名称,对应右键References时添加的项目名称-->
      </Component>
		
		</ComponentGroup>
	</Fragment>
</Wix>

4.生成安装包；

生成的文件如下：

双击wixSetupProject1.msi就可以直接安装，安装速度很快，无其他步骤，在文件路径C:\Programm Files(x86)下可根据名称找到对应文件夹下的软件程序，但桌面和菜单栏还无此图标，因为还没有配置。

5.软件卸载，打开控制面板即可找到对应软件程序。

当时下载的是【WiX v3 - Visual Studio 2022 Extension】，在最后安装包生成时报错了：

错误：The WiX Toolset v3.11 build tools must be installed to build this proiect. Todownload the WiX Toolset, see https://wixtoolset.org/releases/v3.11/stable

（有道翻译：必须安装WiX Toolset v3.11构建工具才能构建此项目。要下载WiX工具集，请参见https://wixtoolset.org/releases/v3.11/stable）

解决方法：下载Wix Toolset Build Tools，重启visual studio2022，再次生成即可成功。