用于部署 WebView2 运行时的 WiX 刻录捆绑包

此示例 WV2DeploymentWiXBurnBundleSample 演示如何使用 WiX Burn Bundle 部署 WebView2 运行时。 执行本文中的步骤,创建通过 Burn Bundle 链接安装 Evergreen WebView2 运行时的 WiX 安装程序。

此示例为 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++支持:

  1. 在单独的窗口或选项卡中,请参阅为 WebView2 设置开发环境中的安装 Visual Studio。 按照该部分中的步骤安装 Visual Studio,包括C++支持。

然后返回到此页并继续执行以下步骤。

步骤 2 - 安装 WiX 工具集生成工具

如果尚未安装,请安装 WiX 工具集:

  1. 在新窗口或选项卡中,转到 “WiX 工具集” ,然后下载 “WiX 工具集”生成工具

  2. 单击该文件 wixnnn.exe ,然后单击“ 打开文件”。

    可能会打开一个对话框,需要启用 .NET Framework 3.5.1

    需要.NET Framework对话框

    如果计算机上已启用 .NET Framework 3.5.1,请跳到继续安装此 WiX 组件。

  3. 单击“ 确定” 按钮。 WiX 安装程序窗口将关闭。

  4. Windows 徽标键Windows 徽标键,键入 Windows 功能,然后按 Enter。 此时会显示 “打开或关闭 Windows 功能 ”对话框。

  5. 选中“.NET Framework 3.5 (包含 .NET 2.0 和 3.0) 检查框:

    打开或关闭 > Windows 功能.NET Framework 3.5

    无需选择子项。

  6. 单击“确定”。 系统可能会提示是否允许Windows 更新下载文件。

    有关详细信息,请参阅在 Windows 11、Windows 10、Windows 8.1 和 Windows 8 上安装 .NET Framework 3.5

  7. 启用 .NET Framework 3.5.1 后,再次运行 wixnnn.exe 该文件。 例如,在 Microsoft Edge 中,依次单击“设置”和“更多、“下载”,然后单击下面的wix311.exe打开文件”。

  8. 单击 WiX 安装程序的 “安装 ”面板。

  9. “用户帐户控制”中,单击“ ”按钮。 WiX 安装程序的顶部显示“已成功安装”。

另请根据下一部分安装 WiX Visual Studio 组件。

步骤 3 - 安装 WiX 工具集 Visual Studio 扩展

如果尚未安装,请安装 WiX 工具集 Visual Studio 2019 扩展:

  1. 在新窗口或选项卡中,转到 “WiX 工具集” ,然后下载并安装扩展:

    • WiX 工具集 Visual Studio 2019 扩展 - 下载的安装程序文件: Votive2019.vsix
  2. “用户帐户控制”中,单击“ ”按钮。 将打开适用于 WiX Visual Studio 扩展的 VSIX 安装程序:

    适用于 WiX Visual Studio 2019 扩展的 VSIX 安装程序

  3. 单击“ 安装 ”按钮。

  4. 如果 正在等待进程关闭的 VSIX 对话框打开,请关闭 Visual Studio。 VSIX 安装程序将继续。

    VSIX 安装程序读取 “安装完成”:

    VSIX 安装程序 - 安装完成 - WiX 工具集 Visual Studio 2019 扩展

  5. 在 VSIX 安装程序中,单击“ 关闭 ”按钮。

  6. 在 WiX 安装程序中,单击“ 退出 ”面板。

  7. 关闭 Visual Studio(如果已打开)。

步骤 4 - 克隆或下载 WebView2示例存储库

  1. 如果尚未执行此操作,请将 WebView2Samples 存储库克隆或下载到本地驱动器。 在单独的窗口或选项卡中,请参阅为 WebView2设置开发环境中的下载 WebView2 示例存储库。 按照该部分中的步骤操作,然后返回到此页面,然后继续以下操作。

步骤 5 - 生成部署项目

  1. 在 WebView2Samples 存储库的本地副本中,使用 Visual Studio 打开 <repo-location>\WebView2Samples\SampleApps\WebView2Samples.sln (不Visual Studio Code) 。

    如果 不支持 ... 。wixproj 对话框出现,安装 WiX 工具集和 WiX 工具集扩展,如上所示:

    不支持 wix 项目消息

  2. 此示例是 WV2DeploymentWiXCustomActionSample 示例的 扩展。 在 解决方案资源管理器中,展开 WV2DeploymentWiXCustomActionSample,然后双击 Product.wxs

  3. 在 中Product.wxs,注释掉 和 下<!-- Step 5: Config execute sequence of custom action --><!-- Step 4: Config Custom Action to download/install Bootstrapper -->的所有 <Binary><CustomAction><Custom> 元素,以便不使用自定义操作。

  4. 在项目下WV2DeploymentWiXBurnBundleSample打开Bundle.wxs。 根据要使用的工作流进行编辑 Bundle.wxs

    若要将 Evergreen WebView2 运行时引导程序与应用一起打包,请执行以下操作:

    • 取消注释 <ExePackage Id="InvokeBootstrapper" ...> 下面的 <!-- [Package Bootstrapper] ... -->元素,并注释掉其他 <ExePackage> 元素。

    若要通过应用中的链接下载 Evergreen WebView2 运行时引导程序,请执行以下操作:

    • 取消注释 <ExePackage Id="DownloadAndInvokeBootstrapper" ...> 下面的 <!-- [Download Bootstrapper] ... -->元素,并注释掉其他 <ExePackage> 元素。
  5. 如果要将 Evergreen WebView2 运行时引导程序与应用一起打包, 请下载 Bootstrapper 并将其置于封闭 SampleApps 文件夹下。

  6. WV2DeploymentWiXBurnBundleSample生成项目。

另请参阅