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

已于 2023-09-25 19:38:26 修改
阅读量865 收藏 1
点赞数 4
分类专栏： VS2022 WiXToolset 文章标签： visual studio windows xml
于 2023-09-24 08:36:50 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_45921305/article/details/133174148
版权

《添加桌面和菜单栏快捷方式》

目录

一、创建桌面快捷方式

Guid码的生成

引用icon图标

二、添加菜单栏快捷方式 

三、添加卸载快捷方式

四、快捷方式代码示例

一、创建桌面快捷方式

1.定义桌面文件夹的目录，在Product.wxs文件的<Fragment>部分定义这个目录；

<Fragment>
    <Directory Id="TARGETDIR" Name="SourceDir">
        <!-- 其他目录定义 -->
        <Directory Id="DesktopFolder" Name="Desktop" />
    </Directory>
</Fragment>

2.在<ComponentGroup>部分，添加一个新的<Component>元素来定义应用程序快捷方式；

<Component Id="DesktopShortcutComponent" Guid="{YOUR-GUID-HERE}">
    <Shortcut Id="DesktopShortcut" Name="YourApp" Target="[INSTALLFOLDER]YourApp.exe" Icon="YourAppIcon" Directory="DesktopFolder" />
</Component>

Name 属性是快捷方式的名称；

Target 属性是快捷方式要启动的目标文件；

Icon 属性是快捷方式的图标（如果有的话）；

Directory 属性设置为 DesktopFolder，以便将快捷方式放在桌面上。

Guid码的生成

1.【工具】——【创建GUID】；

2.有六种GUID格式选择，这里我选择第四种的；

3.新建GUID，然后复制，把它粘贴到对应地方即可。

引用icon图标

ps：可以先在项目的资源文件中添加icon图标，然后在product中引用。

步骤如下：

（1）打开winform项目，【项目】——【（项目名称）属性】，找到【资源】，然后【添加资源】，选择【添加现有文件】；

（2）icon图标添加完毕后，打开Product.wxs文件，在<Product>元素中引用；

<Icon Id="Icon名字" SourceFile="$(var.项目名字.ProjectDir)Resources\icon图标名字.ico" />

<Icon Id="YourAppIcon" SourceFile="$(var.YourProject.ProjectDir)Resources\icon.ico" /><!--项目资源-->

（3）最后在 <Component>元素中的修改Icon="Icon名字"对应上Icon的id。

3.在安装清单<Feature>元素中引用这个组件，以确保它会被安装；

<Feature Id="ProductFeature" Title="YourApp" Level="1">
    <ComponentGroupRef Id="ProductComponents" />
    <ComponentRef Id="DesktopShortcutComponent" />
</Feature>

4.此时运行构建WiX项目就会出现以下错误；

 ICE验证错误参考：ICE 参考 - Win32 apps | Microsoft Learn

这个错误ICE43表示组件（DesktopShortcutComponent）包含了非广告（non-advertised）的快捷方式。WiX 默认要求组件的 KeyPath 使用注册表项（Registry Key）而不是文件。

解决方法：

在<ComponentGroup>部分，<Component>元素中添加一个RegistryValue元素。

<Component Id="DesktopShortcutComponent" Guid="{YOUR-GUID-HERE}">
    <Shortcut Id="DesktopShortcut" Name="YourApp" Target="[INSTALLFOLDER]YourApp.exe" Icon="YourAppIcon" Directory="DesktopFolder" />

    <!-- 使用注册表项作为 KeyPath -->
    <RegistryValue Root="HKCU" Key="Software\YourCompany\YourApp" Name="Installed" Type="integer" Value="1" KeyPath="yes" />
</Component>

Root 设置为 HKCU（HKEY_CURRENT_USER，当前用户的注册表根键），

Key 设置为注册表项的路径（你可以根据你的需要自定义这个路径），

Name 设置为 Installed，

Type 设置为 integer，

Value 设置为 1，

KeyPath 设置为 yes，以指定这个注册表项作为组件的 KeyPath。

5.解决了ICE43的错误后重新生成WiX项目，其余两个错误没有出现了，该项目就构建成功了。

WiX项目生成文件如下，点击.msi即可安装；

（左边为桌面快捷方式设置的图标，中间为项目设置的图标，右边为控制面板设置的图标）

修改中间和右边的图标可查看：【修改控制面板里的应用程序图标 】

二、添加菜单栏快捷方式 

 1.定义菜单栏快捷方式的目录，在Product.wxs文件的<Fragment>部分定义这个目录；

	<Fragment>
		<!--安装程序的目录/C盘-->
		<Directory Id="TARGETDIR" Name="SourceDir">
			 <!-- 定义菜单栏快捷方式目录 -->
			<Directory Id="ProgramMenuFolder" Name="Programs"/>
			<Directory Id="ProgramFilesFolder">
				<Directory Id="INSTALLFOLDER" Name="YourAppName" >					
				</Directory>
			</Directory>
		</Directory>			
	</Fragment>

2.在<ComponentGroup>部分，添加一个新的<Component>元素来定义应用程序快捷方式； 

菜单栏快捷方式的GUID码与桌面快捷方式的GUID码不是同一个编码！需要新建GUID！

新建GUID：【Guid码的生成】

<!--菜单栏快捷方式-->
<Component Id="StartMenuShortcutComponent" Guid="{YOUR-GUID-HERE}">
	<Shortcut Id="StartMenuShortcut" Name="YourApp" Target="[INSTALLFOLDER]YourApp.exe" Icon="YourAppIcon" Directory="ProgramMenuFolder" />
	<!-- 使用注册表项作为 KeyPath -->
	<RegistryValue Root="HKCU" Key="Software\YourCompany\YourApp" Name="Installed" Type="integer" Value="1" KeyPath="yes" />
</Component>

Name 属性是快捷方式的名称；

Target 属性是快捷方式要启动的目标文件；

Icon 属性是快捷方式的图标（如果有的话）；

Directory 属性设置为 ProgramMenuFolder，以便将快捷方式放在菜单栏上。

要添加一个RegistryValue元素，避免出现ICE错误。

Root 设置为 HKCU（HKEY_CURRENT_USER，当前用户的注册表根键），

Key 设置为注册表项的路径（你可以根据你的需要自定义这个路径），

Name 设置为 Installed，

Type 设置为 integer，

Value 设置为 1，

KeyPath 设置为 yes，以指定这个注册表项作为组件的 KeyPath。

 3.在安装清单<Feature>元素中引用这个组件，以确保它会被安装；

<Feature Id="ProductFeature" Title="Your Application" Level="1">
  <ComponentGroupRef Id="ProductComponents" />
  <!-- 添加菜单栏快捷方式的 ComponentRef -->
  <ComponentRef Id="StartMenuShortcutComponent" />
</Feature>

4.【 引用icon图标】，为快捷方式创建icon图标；

<Icon Id="Icon名字" SourceFile="$(var.项目名字.ProjectDir)Resources\icon图标名字.ico" />

<Icon Id="YourAppIcon" SourceFile="$(var.YourProject.ProjectDir)Resources\icon.ico" /><!--菜单栏快捷方式图标-->

5.生成WiX项目，成功构建后，点击.msi安装即可。 

 

效果如下图： 

上面为控制面板程序图标，中间为桌面快捷方式图标，下面为菜单栏快捷方式图标。

（图标还是尽量保持一致最好）

 

三、添加卸载快捷方式

1.在<ComponentGroup>部分，添加一个新的<Component>元素来定义卸载程序快捷方式；

新建GUID：【Guid码的生成】

<!--卸载程序快捷方式-->
<Component Id="UninstallShortcutComponent" Guid="{CEFF3B30-0706-4DFC-9D18-1AFF91A38135}">
	<Shortcut Id="UninstallProduct" Name="Uninstall" Target="[SystemFolder]msiexec.exe" Arguments="/x [ProductCode]" Description="Uninstall MyApp." />
	<!-- 使用注册表项作为 KeyPath -->
	<RegistryValue Id="RegUninstallShortcut" Root="HKCU" Key="Software\MyCompany\MyApp_demo" Name="UninstallShortcut" Type="string" Value="" KeyPath="yes" />		
</Component>

2.在安装清单<Feature>元素中引用这个组件，以确保它会被安装；

		<Feature Id="ProductFeature" Title="MyApp" Level="1">
			<ComponentGroupRef Id="ProductComponents" />
            <!--其他组件-->
			<ComponentRef Id="UninstallShortcutComponent" /><!--卸载-->			
		</Feature>

3.在安装的文件夹下就可以找到对应卸载方式了。

 

四、快捷方式代码示例

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
	<Product Id="*" Name="MyApp" Language="2052" Version="1.0.0.0" Manufacturer="MyAppDemo" UpgradeCode="57415bb9-6494-4410-b381-2adb83574583">
		<Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />

		<MajorUpgrade DowngradeErrorMessage="A newer version of [ProductName] is already installed." />
		<MediaTemplate />

		<Feature Id="ProductFeature" Title="MyApp" Level="1">
			<ComponentGroupRef Id="ProductComponents" />
			<ComponentRef Id="ProductComponent" />
			<ComponentRef Id="DesktopShortcutComponent" /><!--桌面-->
			<ComponentRef Id="StartMenuShortcutComponent" /><!--菜单栏-->
			<ComponentRef Id="UninstallShortcutComponent" /><!--卸载-->
		</Feature>
		
		<!--设置用户UI风格，自定义安装程序-->
		<UI>
			<!--<UIRef Id="WixUI_InstallDir" />--><!--默认UI风格-->
			<UIRef Id="WixUI_Minimal" />
		</UI>
		<!--WIXUI_INSTALLDIR 指定安装目录的默认值，默认情况下将使用 INSTALLFOLDER 作为安装路径-->
		<!--<Property Id="WIXUI_INSTALLDIR" Value="INSTALLFOLDER" />-->			
		<!-- 引用图标 -->
		<Icon Id="MyAppIcon" SourceFile="$(var.WindowsForms1.ProjectDir)Resources\vs_code128x128.ico" /> <!--控制面板图标-->
		<Icon Id="MyAppIcon_purple" SourceFile="$(var.WindowsForms1.ProjectDir)Resources\vs_purple.ico" /><!--桌面快捷方式图标-->
		<Icon Id="MyAppIcon_green" SourceFile="$(var.WindowsForms1.ProjectDir)Resources\vs_green.ico" /><!--菜单栏快捷方式图标-->
		<!-- 控制面板引用程序图标 -->
		<Property Id="ARPPRODUCTICON" Value="MyAppIcon" />
	
	</Product>

	<Fragment>
		<!--安装程序的目录/C盘-->
		<Directory Id="TARGETDIR" Name="SourceDir">
			<!--定义桌面快捷方式-->
			<Directory Id="DesktopFolder" Name="Desktop" />
			 <!-- 定义菜单栏快捷方式 -->
			<Directory Id="ProgramMenuFolder" Name="Programs" >
				<!-- 新目录下创建快捷方式--><!--
				<Directory Id="MyAppMenuFolder" Name="MyAppSetup" />-->
			</Directory>
			<Directory Id="ProgramFilesFolder">
				<Directory Id="INSTALLFOLDER" Name="MyApp" >					
				</Directory>
			</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> -->
			
			<!--引用的项目名称,对应右键References时添加的项目名称-->
			<Component Id="ProductComponent">
				<File Source="$(var.WindowsForms1.TargetPath)" />				
			</Component>

			<!--桌面快捷方式-->
			<Component Id="DesktopShortcutComponent" Guid="{D94CF07F-262D-4A65-84D6-810D5E71B7D5}">
				<Shortcut Id="DesktopShortcut" Name="MyApplication" Target="[INSTALLFOLDER]WindowsForms1.exe" Icon="MyAppIcon_purple" Directory="DesktopFolder" />
				<!-- 使用注册表项作为 KeyPath -->
				<RegistryValue Root="HKCU" Key="Software\MyCompany\MyApp_demo" Name="Installed" Type="integer" Value="1" KeyPath="yes" />
			</Component>
			
			<!--菜单栏快捷方式-->
			<Component Id="StartMenuShortcutComponent" Guid="{7AFCA2B2-DDA7-4E73-936D-03628E03E894}">
				<Shortcut Id="StartMenuShortcut" Name="MyApplication" Target="[INSTALLFOLDER]WindowsForms1.exe" Icon="MyAppIcon_green" Directory="ProgramMenuFolder" />	
				<!-- 使用注册表项作为 KeyPath -->
				<RegistryValue Root="HKCU" Key="Software\MyCompany\MyApp_demo" Name="Installed" Type="integer" Value="1" KeyPath="yes" />						
			</Component>

			<!--卸载程序快捷方式-->
			<Component Id="UninstallShortcutComponent" Guid="{CEFF3B30-0706-4DFC-9D18-1AFF91A38135}">
				<Shortcut Id="UninstallProduct" Name="Uninstall" Target="[SystemFolder]msiexec.exe" Arguments="/x [ProductCode]" Description="Uninstall MyApp." />
				<RegistryValue Id="RegUninstallShortcut" Root="HKCU" Key="Software\MyCompany\MyApp_demo" Name="UninstallShortcut" Type="string" Value="" KeyPath="yes" />		
			</Component>

		</ComponentGroup>
	</Fragment>
</Wix>

参考：Wix 安装部署教程（四） 添加安装文件及快捷方式

上一篇：VS2022利用WiX Toolset打包winform程序安装包（4）修改控制面板里的应用程序图标

Deccc.
关注
  • 4
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
10.VS2022打包应用程序成安装包
qq_27860623的博客
08-02 996
ERROR: 要在“系统必备”对话框中启用“从与我的应用程序相同的位置下载系统必备组件”，必须将“Microsoft .NET Framework 4.8 (x86 和 x64)”项的文件“DotNetFX48\NDP48-x86-x64-AllOS-ENU.exe”下载到本地计算机。将 ndp48-x86-x64-allos-enu.exe 安装包放到这一层文件目录即可，而ndp48-x86-x64-allos-chs.exe安装包需要放入再里面的zh-Hans文件夹中去。
WixSharp打包软件安装包入门教程
a513436535的博客
08-14 1033
WixSharp是使用 C# 语法编写的脚本文件构建完整 MSI 或 WiX 源代码的框架。
VS2022 C# 打包步骤
编程圈子-谢厂节的博客
05-05 1万+
VS2022 C# 打包步骤一、准备工作二、安装扩展三、建立一个解决方案1. 右键选择解决方案，选择新增项目 - Setup Project2. 在解决方案按右键选择Setup1-View-启动条件3. 选择目标FrameWork 版本4. 设置默认安装目录4. 生成 一、准备工作 vs2022 二、安装扩展 点击vs2022菜单-扩展-管理扩展-联机，搜索 Visual Studio Installer Project ，点击下载。 关闭vs，按提示继续操作： 三、建立一个解决方案 1. 右键选择
使用WIX打包.net7.0的应用程序安装包
最新发布
weixin_44531910的博客
04-25 1275
由于项目需要，需要.net7开发的winform应用程序进行打包生成msi安装包，因为是.net7的项目，所以选择了wix进行安装包的打包处理，但是网上搜到的相关的技术文档都比较老，而且多数使用的wix3.0版本对.net framework的winform应用程序的打包。经过阅读官网，终于实现了打包的功能，于是将自己实现方式做了一个整理和分享。参考链接：链接:wix官网firegiant官网以上就是我打包一个使用.net7.0开发的应用程序的全过程。
VisualStudio（2022）- 打包项目文件为.exe安装包
热门推荐
怀秋秋意的博客
12-13 2万+
使用VisualStudio软件（2022）将项目文件为打包为.exe安装包步骤详解（保姆级教程）
【小白专用】WinForm项目打包成一个exe安装包教程（VS2022）
zgscwxd的博客
12-25 5991
winform程序打包为安装文件
Wix 软件打包（一）
qq_35159235的博客
07-22 2664
简单的wix安装打包   对winform或者wpf打包visual studio有自己的插件VS Installer,但是使用时遇到一些问题，如桌面快捷方式指向的文件不是运行程序，安装运行环境时每个环境都需要询问无法跳过等，在网上看到Wix（Windows Intstall XML）打包的方式。Wix是一种使用xml脚本配置部署的打包方式 1、首先在官网（https://wixtoolset.org/）下载WiX Toolset build tools 进行安装 点击Install安装，我这里是已经安装完
利用Wix打包安装包
m0_51961114的博客
12-10 1948
利用Wix打包安装包背景具体步骤1、安装 WiX Toolset 工具集2、安装 WiX Toolset 系列 Visual Studio 插件3、创建Wix工程4、添加工程文件5、修改Product元素6、修改Package元素7、修改MajorUpgrade元素8、修改Media属性9、设置安装引导界面10、添加WPF项目文件11、添加桌面快捷方式12、添加菜单快捷方式13、设置安装引导界面语言环境14、最后设置源码 背景 将指定WPF项目利用Wix打包为安装包！ 具体步骤 以打包名为 MRISoftw
如何为winform程序打包(图解).pdf
09-26
将一个WinForm程序打包成可执行文件（exe）或者安装包（setup）是发布软件的重要步骤，这使得用户能够轻松安装和运行程序。下面将详细阐述如何为WinForm程序进行打包。 1. **创建安装项目** - 打开Visual Studio，...
C#程序打包与安装后快捷方式属性设置
10-22
2. 第三方工具：除了Visual Studio，还有许多第三方打包工具如WiX Toolset、Inno Setup等，它们提供了更高级的定制选项，可以满足更复杂的需求。 二、安装时固定地址的设置 1. 安装路径：在创建安装项目时，可以在...
c#打包(winform一个简单的打包过程)
01-19
在C#编程环境中，开发完一个WinForm应用程序后，为了让其他用户能够方便地安装和使用，我们需要将其打包成安装程序。Visual Studio（VS）作为C#的主要开发工具，内置了强大的发布和打包功能，使得这一过程变得简单易...
生成MSI安装包工具Wix帮助
02-24
MSI安装包工具Wix帮助文档，这个可以直接生成MSI安装文件
c#WinForm生成安装程序
01-24
在C# WinForm应用开发完成后，为了让用户能够方便地安装和使用我们的软件，我们需要将其打包成一个安装程序。本文将详细介绍如何使用C# WinForm生成安装程序，包括所需的工具、步骤以及注意事项。 首先，让我们了解...
C#WinForm图书馆管理系统（源码、安装程序和数据库）
04-09
系统的安装程序通常使用安装向导工具，如Visual Studio Installer或WiX Toolset，来打包所有依赖项和资源，生成一个可执行的安装包，用户只需点击几下即可完成安装。 在实际使用中，管理员可以通过系统后台进行图书...
VS2022利用WiX Toolset打包winform程序安装包（2）
Deccc.的博客
09-19 481
XML文档元素部分解释整理，更全面的内容请参考 WiX Toolset 的官方文档。
WinForm项目打包成一个exe安装包教程（VS2022）
蓝多多的小仓库
08-08 8956
右击Application Folder ---> Add ---> 文件 --->把C:\Windows\System32下的msiexec.exe文件添加到Application Folder中。右击 Application Folder ---> Add --->项目输出，选择项目、主输出 ---> 确定。右击Application Folder（应用程序文件夹）---> Add ---> 文件，将你的icon文件导入。右击您新建的Setup项目---> 属性--->点击Prerequisites…
Visual Studio 2022 究竟如何打包成安装包
weixin_43056212的博客
12-13 499
我都是不打包的，后来我看了同行们都打包了，这样看上去很专业的样子，为了让自己显得比较专业一点，我也勉为其难打个包吧。当你生成出错的时候，会提示你，你的版本号。然而，打包的时候，碰到一些问题，顺便就在这里做个记录，权当备忘，碰到类似问题的工程师也可以有个借鉴。给你的快捷方式起个名字，然后拖到快捷方式的文件夹下，最后在快捷方式的属性里给他设置一个图标。另外一个版本，放这个路径，然后出去反键你的setup project，然后点生成，就OK了。这里，我主要讲一下，不让客户从网上下载.NET框架，我直接附带给他。
Wix打包系列（一）如何使用wix制作安装程序
03-29 2349
<br />  Wix打包系列（一）如何使用wix制作安装程序<br />    最近由于项目需要，需要给客户制作安装程序，一开始使用vs2005自带的打包工程来打包，但用了一段时间发现vs打包太死板，而且使用起来问题很多。收费的商业打包工具不在我考虑范围内，于是在网上找到了wix，稍微了解了下，发现wix的确可以满足我的需求；但是网上wix中文的资料少的可怜，百度，google上搜索到关于wix中文的资料少的可怜，有的只是一些简单的应用，还不足以满足我的要求；没办法，只能靠自己了，还好项目不是很急，于是开
VS2022 VC++打包生成安装文件图文详细历程----补充说明一
cjmsea的博客
04-22 2795
VS2022的程序设计，打包，安装，缺少dll的问题解决办法
WiX Toolset
08-15
WiX Toolset 是一个开源的 Windows 安装程序创建工具集。它可以帮助开发人员创建和打包 Windows 安装程序，并提供了一套强大的工具和库来定义安装界面、文件位置、注册表项、服务等。它使用 XML 文件来描述安装包的内容和行为。WiX Toolset 是一个功能强大且灵活的工具，适用于各种规模和复杂度的安装项目。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值