用于部署 WebView2 运行时的 WiX 刻录捆绑包
此示例 WV2DeploymentWiXBurnBundleSample 演示如何使用 WiX Burn Bundle 部署 WebView2 运行时。 执行本文中的步骤,创建通过 Burn Bundle 链接安装 Evergreen WebView2 运行时的 WiX 安装程序。
- 示例名称: WV2DeploymentWiXBurnBundleSample
- 存储库目录: WV2DeploymentWiXBurnBundleSample
- 项目文件:
WV2DeploymentWiXBurnBundleSample.wixproj
此示例为 Win32 示例应用创建 WiX 安装程序。 此示例使用 WiX Burn Bundle 链接安装 Evergreen WebView2 运行时。
此示例演示了为应用分发 WebView2 运行时的以下两种不同的分发方法:
- 通过存储在应用中的链接下载 Evergreen WebView2 Runtime Bootstrapper。
- 将 Evergreen WebView2 运行时引导程序打包到应用。
本示例未演示的另一种方法是将 Evergreen WebView2 运行时独立安装程序与应用一起打包。 此方法与将 Evergreen WebView2 运行时引导程序打包到应用非常相似。
有关方法的概述,请参阅在分发应用和WebView2 运行时中部署 Evergreen WebView2 运行时。
步骤 1 - 安装 Visual Studio
Microsoft Visual Studio 是必需的。 此示例不支持Microsoft Visual Studio Code。
如果尚未安装 Visual Studio (最低要求版本) ,C++支持:
- 在单独的窗口或选项卡中,请参阅为 WebView2 设置开发环境中的安装 Visual Studio。 按照该部分中的步骤安装 Visual Studio,包括C++支持。
然后返回到此页并继续执行以下步骤。
步骤 2 - 安装 WiX 工具集生成工具
如果尚未安装,请安装 WiX 工具集:
在新窗口或选项卡中,转到 “WiX 工具集” ,然后下载 “WiX 工具集”生成工具。
单击该文件
wixnnn.exe
,然后单击“ 打开文件”。可能会打开一个对话框,需要启用 .NET Framework 3.5.1:
如果计算机上已启用 .NET Framework 3.5.1,请跳到继续安装此 WiX 组件。
单击“ 确定” 按钮。 WiX 安装程序窗口将关闭。
按 Windows 徽标键
,键入 Windows 功能,然后按 Enter。 此时会显示 “打开或关闭 Windows 功能 ”对话框。
选中“.NET Framework 3.5 (包含 .NET 2.0 和 3.0) 检查框:
无需选择子项。
单击“确定”。 系统可能会提示是否允许Windows 更新下载文件。
有关详细信息,请参阅在 Windows 11、Windows 10、Windows 8.1 和 Windows 8 上安装 .NET Framework 3.5。
启用 .NET Framework 3.5.1 后,再次运行
wixnnn.exe
该文件。 例如,在 Microsoft Edge 中,依次单击“设置”和“更多”、“下载”,然后单击下面的wix311.exe
“打开文件”。单击 WiX 安装程序的 “安装 ”面板。
在 “用户帐户控制”中,单击“ 是 ”按钮。 WiX 安装程序的顶部显示“已成功安装”。
另请根据下一部分安装 WiX Visual Studio 组件。
步骤 3 - 安装 WiX 工具集 Visual Studio 扩展
如果尚未安装,请安装 WiX 工具集 Visual Studio 2019 扩展:
在新窗口或选项卡中,转到 “WiX 工具集” ,然后下载并安装扩展:
- WiX 工具集 Visual Studio 2019 扩展 - 下载的安装程序文件:
Votive2019.vsix
- WiX 工具集 Visual Studio 2019 扩展 - 下载的安装程序文件:
在 “用户帐户控制”中,单击“ 是 ”按钮。 将打开适用于 WiX Visual Studio 扩展的 VSIX 安装程序:
单击“ 安装 ”按钮。
如果 正在等待进程关闭的 VSIX 对话框打开,请关闭 Visual Studio。 VSIX 安装程序将继续。
VSIX 安装程序读取 “安装完成”:
在 VSIX 安装程序中,单击“ 关闭 ”按钮。
在 WiX 安装程序中,单击“ 退出 ”面板。
关闭 Visual Studio(如果已打开)。
步骤 4 - 克隆或下载 WebView2示例存储库
- 如果尚未执行此操作,请将
WebView2Samples
存储库克隆或下载到本地驱动器。 在单独的窗口或选项卡中,请参阅为 WebView2设置开发环境中的下载 WebView2 示例存储库。 按照该部分中的步骤操作,然后返回到此页面,然后继续以下操作。
步骤 5 - 生成部署项目
在 WebView2Samples 存储库的本地副本中,使用 Visual Studio 打开
<repo-location>\WebView2Samples\SampleApps\WebView2Samples.sln
(不Visual Studio Code) 。如果 不支持 ... 。wixproj 对话框出现,安装 WiX 工具集和 WiX 工具集扩展,如上所示:
此示例是 WV2DeploymentWiXCustomActionSample 示例的 扩展。 在 解决方案资源管理器中,展开 WV2DeploymentWiXCustomActionSample,然后双击
Product.wxs
。在 中
Product.wxs
,注释掉 和 下<!-- Step 5: Config execute sequence of custom action -->
<!-- Step 4: Config Custom Action to download/install Bootstrapper -->
的所有<Binary>
、<CustomAction>
和<Custom>
元素,以便不使用自定义操作。在项目下
WV2DeploymentWiXBurnBundleSample
打开Bundle.wxs
。 根据要使用的工作流进行编辑Bundle.wxs
:若要将 Evergreen WebView2 运行时引导程序与应用一起打包,请执行以下操作:
- 取消注释
<ExePackage Id="InvokeBootstrapper" ...>
下面的<!-- [Package Bootstrapper] ... -->
元素,并注释掉其他<ExePackage>
元素。
若要通过应用中的链接下载 Evergreen WebView2 运行时引导程序,请执行以下操作:
- 取消注释
<ExePackage Id="DownloadAndInvokeBootstrapper" ...>
下面的<!-- [Download Bootstrapper] ... -->
元素,并注释掉其他<ExePackage>
元素。
- 取消注释
如果要将 Evergreen WebView2 运行时引导程序与应用一起打包, 请下载 Bootstrapper 并将其置于封闭
SampleApps
文件夹下。WV2DeploymentWiXBurnBundleSample
生成项目。
另请参阅
- 在分发应用和 WebView2 运行时中部署 EvergreenWebView2 运行时。