WiX 燒錄套件以部署 WebView2 執行環境

此範例 WV2DeploymentWiXBurnBundleSample 示範如何使用 WiX 燒錄套件來部署 WebView2 執行環境。 請依照本文步驟製作一個 WiX 安裝程式，透過 Burn Bundle 串接安裝 Evergreen WebView2 執行環境。

• 範例名稱： WV2DeploymentWiXBurnBundleSample
• Repo 目錄： WV2DeploymentWiXBurnBundleSample
• 專案檔案： WV2DeploymentWiXBurnBundleSample.wixproj

這個範例會為 Win32 範例應用程式建立一個 WiX 安裝程式。 本範例使用 WiX Burn Bundle 來串接安裝 Evergreen WebView2 執行環境。

以下範例展示了兩種不同的 WebView2 執行時分發方式：

• 透過應用程式中儲存的連結下載 Evergreen WebView2 執行時啟動工具。
• 將 Evergreen WebView2 執行時啟動工具打包到你的應用程式中。

另一種方法，這個範例中沒有展示，是將 Evergreen WebView2 執行時獨立安裝程式打包在你的應用程式中。 這種做法與將 Evergreen WebView2 執行時導機程式打包在應用程式中非常相似。

關於這些方法的概述，請參閱「 Deploying the Evergreen WebView2 Runtime 」中的「 Distribute your app」和「WebView2 Runtime」。

步驟 1 - 安裝 Visual Studio

必須使用 Microsoft Visual Studio。 本範例不支援 Microsoft Visual Studio Code。

如果 Visual Studio (尚未安裝) 最低所需版本，且支援 C++：

1. 在另一個視窗或分頁中，請參考「 安裝 Visual Studio 的 WebView2 開發環境設定」。 請依照該部分的步驟安裝 Visual Studio，包括支援 C++。

然後回到這個頁面，繼續以下步驟。

步驟 2 - 安裝 WiX 工具組建置工具

如果還沒完成，請安裝 WiX 工具組：

1. 在新視窗或分頁中，前往 WiX 工具組 ，然後下載 WiX 工具組建置工具。

2. 點選檔案， wixnnn.exe 然後點 選開啟檔案。

   可能會開啟一個對話框，需要啟用 .NET Framework 3.5.1：

   

   如果您的機器已經啟用了 .NET Framework 3.5.1，請跳過繼續安裝這個 WiX 元件。

3. 點擊 確定 按鈕。 WiX 安裝程式視窗關閉。

4. 按下 Windows 標誌，輸入 Windows 功能，然後按下 Enter。 螢幕上會出現 「開啟或關閉 Windows 功能 」的對話框。

5. 選擇包含 .NET 2.0 和 3.0) 的 3.5 .NET Framework (

   

   你不需要選擇子項目。

6. 按一下確定。 你可能會被提示是否允許 Windows Update 下載檔案。

   欲了解更多資訊，請參閱「在 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. 在 使用者帳戶控制中，點擊 「是」 按鈕。 VSIX 安裝程式用於 WiX Visual Studio 擴充功能開啟：

   

3. 點擊 安裝 按鈕。

4. 如果有 等待程序關閉的 VSIX 對話框打開，請關閉 Visual Studio。 VSIX 安裝人員繼續進行。

   VSIX 安裝程式顯示 安裝完成：

   

5. 在 VSIX 安裝程式中，點擊 關閉 按鈕。

6. 在 WiX 安裝程式中，點選 退出 面板。

7. 如果 Visual Studio 是開著的，請關閉它。

步驟 4 - 複製或下載 WebView2Samples 倉庫

1. 如果還沒做，請複製或下載 WebView2Samples 倉庫到本地硬碟。 在另一個視窗或分頁中，請參考「為 WebView2 建立你的開發環境下載 WebView2Samples 倉庫」。 請依照該部分的步驟操作，然後返回此頁繼續下方。

步驟 5 - 建立部署專案

1. 在你本機的 WebView2Samples 倉庫中，用 Visual Studio 開啟 <repo-location>\WebView2Samples\SampleApps\WebView2Samples.sln (不要Visual Studio Code) 。

   如果 無支持者......出現 Wixproj 對話框，請安裝 WiX 工具組和 WiX 工具組擴充功能，如上方所示：

   

2. 此範例是 WV2DeploymentWiXCustomActionSample 範例的擴充。 在方案總管中，展開 WV2DeploymentWiXCustomActionSample，然後雙擊 Product.wxs。

3. 在 Product.wxs中，註解所有 <Binary>、 <CustomAction><Custom> 、 及 元素<!-- Step 4: Config Custom Action to download/install Bootstrapper --><!-- Step 5: Config execute sequence of custom action -->，避免使用自訂動作。

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 。

另請參閱

• 在 Distribute your app 和 WebView2 執行時部署 Evergreen WebView2 執行環境。