次の方法で共有

WebView2 ランタイムをデプロイするための WiX カスタム アクション

このサンプル の WV2DeploymentWiXCustomActionSample は、WiX カスタム アクションを使用して WebView2 ランタイムをデプロイする方法を示しています。

  • サンプル名: WV2DeploymentWiXCustomActionSample
  • リポジトリ ディレクトリ: WV2DeploymentWiXCustomActionSample
  • プロジェクト ファイル: WV2DeploymentWiXCustomActionSample.wixproj

このサンプルでは、アプリでエバーグリーン WebView2 ランタイムをデプロイする方法を理解するために、WebView2APISample 用の WiX インストーラーを作成し、WiX カスタム アクションを使用して、Evergreen WebView2 ランタイムをチェーンインストールします。

このサンプルでは、いくつかの異なるデプロイ方法を示します。

  • リンクを使用して、Evergreen WebView2 ランタイム ブートストラップをダウンロードする。
  • アプリでエバーグリーン WebView2 ランタイム ブートストラップをパッケージ化する。
  • アプリでエバーグリーン WebView2 ランタイム スタンドアロン インストーラーをパッケージ化する。

手順 1 - C++ サポートを使用して Visual Studio 2019 をインストールする

Microsoft Visual Studio が必要です。 このサンプルでは、Microsoft Visual Studio Code はサポートされていません。

  1. Visual Studio - C++ サポートを使用して Visual Studio 2019 (最小必須バージョン) をインストールしていない場合は、別のウィンドウまたはタブで、「WebView2 用の開発環境をセットアップする」の「Visual Studio のインストール」を参照してください。 このセクションの手順に従って、C++ サポートを使用して Visual Studio 2019 をインストールし、このページに戻り、以下の手順を続行します。

手順 2 - WiX ツールセット ビルド ツールをインストールする

まだ完了していない場合は、WiX ツールセットをインストールします。

  1. 新しいウィンドウまたはタブで、[ WiX ツールセット] に移動し、 WiX ツールセットビルド ツールツールをダウンロードします。

  2. wixnnn.exe ファイルをクリックし、[ファイルを開く] をクリックします。

    ダイアログが開く場合があります。.NET Framework 3.5.1 を有効にする必要があります。

    [.NET Frameworkが必要] ダイアログ

    コンピューター.NET Framework 3.5.1 が既に有効になっている場合は、先に進んでこの WiX コンポーネントのインストールを続行してください。

  3. [OK] ボタンをクリック します 。 WiX インストーラー ウィンドウが閉じます。

  4. Windows ロゴ キー Windows ロゴ キーを押し、「Windows 機能」と入力し、Enter キーを押します。 [ Windows 機能のオンとオフを切り替える ] ダイアログが表示されます。

  5. .NET Framework 3.5 (.NET 2.0 と 3.0 を含む) チェック ボックスを選択します。

    Windows 機能を 3.5 > .NET Frameworkオンまたはオフにする

    子項目を選択する必要はありません。

  6. [OK] をクリックします。 ファイルをダウンロード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 インストーラー for WiX Visual Studio 拡張機能が開きます。

    VSIX インストーラー for WiX Visual Studio 2019 拡張機能

  3. [ インストール ] ボタンをクリックします。

  4. プロセスの シャットダウンを待機している VSIX ダイアログが開いた場合は、Visual Studio を閉じます。 VSIX インストーラーが続行されます。

    VSIX インストーラーは、 インストール完了と読み取ります。

    VSIX インストーラー - インストール完了 - WiX ツールセット Visual Studio 2019 拡張機能

  5. VSIX インストーラーで、[ 閉じる ] ボタンをクリックします。

  6. WiX インストーラーで、[ 終了 ] パネルをクリックします。

手順 4 - WebView2Samples リポジトリを複製する

  1. まだ完了していない場合は、 WebView2Samples リポジトリをローカル ドライブに複製します。 別のウィンドウまたはタブで、「 WebView2 の開発環境をセットアップする」の「WebView2Samples リポジトリを複製 する」を参照 してください。 そのセクションの手順に従って、このページに戻り、以下に進みます。

手順 5 - Visual Studio でソリューションを開く

  1. WebView2Samples リポジトリのローカル コピーで、(Visual Studio Code ではなく) Visual Studio で <repo-location>\WebView2Samples\SampleApps\WebView2Samples.sln を開きます。

手順 6 - Product.wxs を編集して、WebView2 ランタイムを配布する方法を構成する

  1. WV2DeploymentWiXCustomActionSample プロジェクトの下でProduct.wxsを開きます。

  2. 使用する方法に応じて Product.wxs を編集します。

アプリがリンクを介してエバーグリーン WebView2 ランタイム ブートストラップ (MicrosoftEdgeWebview2Setup.exe) をダウンロードする場合:

  1. [<!-- Step 4: Config Custom Action to download/install Bootstrapper -->] で、<!-- [Download Bootstrapper] ... -->の下の <CustomAction Id='DownloadAndInvokeBootstrapper' ...> 要素のコメントを解除します。

  2. Step 4の下の他の<Binary>および<CustomAction>要素をコメントアウトします。

  3. [<!-- Step 5: Config execute sequence of custom action -->] で、<!-- [Download Bootstrapper] ...-->の下の <Custom Action='DownloadAndInvokeBootstrapper' ...> 要素のコメントを解除します。

  4. Step 5の下の他の<Custom>要素をコメントアウトします。

方法 2: アプリでエバーグリーン WebView2 ランタイム ブートストラップをパッケージ化する

アプリでエバーグリーン WebView2 ランタイム ブートストラップ (MicrosoftEdgeWebview2Setup.exe) をパッケージ化する場合:

  1. [<!-- Step 4: Config Custom Action to download/install Bootstrapper -->] で、<!-- [Package Bootstrapper] ... -->の下の<Binary Id="MicrosoftEdgeWebview2Setup.exe" ...>と<CustomAction Id='InvokeBootstrapper' ...>要素のコメントを解除します。

  2. Step 4の下の他の<Binary>および<CustomAction>要素をコメントアウトします。

  3. [<!-- Step 5: Config execute sequence of custom action -->] で、<!-- [Package Bootstrapper] ...-->の下の <Custom Action='InvokeBootstrapper' ...> 要素のコメントを解除します。

  4. Step 5の下の他の<Custom>要素をコメントアウトします。

方法 3: アプリでエバーグリーン WebView2 ランタイム スタンドアロン インストーラーをパッケージ化する

アプリを使用してエバーグリーン WebView2 ランタイム スタンドアロン インストーラーをパッケージ化する場合:

  1. [<!-- Step 4: Config Custom Action to download/install Bootstrapper -->] で、<!-- [Package Standalone Installer] ... -->の下の<Binary Id="MicrosoftEdgeWebView2RuntimeInstallerX64.exe" ...>と<CustomAction Id='InvokeStandalone' ...>要素のコメントを解除します。

  2. Step 4の下の他の<Binary>および<CustomAction>要素をコメントアウトします。

  3. X64 以外のデバイスを対象としている場合は、正しいアーキテクチャを反映するように MicrosoftEdgeWebView2RuntimeInstallerX64 ファイル名を編集することもできます。

  4. [<!-- Step 5: Config execute sequence of custom action -->] で、<!-- [Package Standalone Installer] ...-->の下の <Custom Action='InvokeStandalone' ...> 要素のコメントを解除します。

  5. Step 5の下の他の<Custom>要素をコメントアウトします。

手順 7 - ブートストラップまたはインストーラーをフォルダーに配置する

ブートストラップ (アプローチ 2) またはスタンドアロン インストーラー (アプローチ 3) のいずれかをアプリでパッケージ化する場合:

  1. ブートストラップまたはスタンドアロン インストーラーをダウンロードします。 Microsoft Edge WebView2 で、[今すぐダウンロード] をクリックして、[WebView2 ランタイムのダウンロード] セクションまで下にスクロールします。

  2. ダウンロードしたブートストラップまたはスタンドアロン インストーラーを、外側の SampleApps フォルダーの下に配置します。

手順 8 - インストーラー プロジェクトをビルドする

  1. WV2DeploymentVSInstallerSample プロジェクトをビルドします。

関連項目