プレビュー チャネルをデプロイしてセルフホストする

  • [アーティクル]

セルフホスティング とは、アプリでプレビュー WebView2 ランタイムをデプロイすることを意味します。 これにより、開発チームは、WebView2 ランタイムのプレビュー バージョンでアプリを毎日使用し、今後の変更が常緑 WebView2 ランタイム (安定版) に到達する前に、特定の WebView2 アプリに影響する問題を見つけることができます。

セルフホスティング アプローチでは、最新のプレビュー WebView2 ランタイムを使用して、発生する可能性のある問題をキャッチするために、アプリの実際の使用方法を提供します。 WebView2 ランタイムの最新バージョンでアプリをテストするための構造化されたアプローチを提供するには、アプリでプレリリース テストを行うのと並行してアプリをセルフホストする必要があります。

自動テストと手動テストの両方を実施する:

  • 自動テストの場合は、プレリリース テストを実行します。つまり、WebView2 ランタイムのプレビュー バージョンを使用したテストを意味します。 プレビュー チャネルを使用したプレリリース テストに関するページを参照してください。
  • 手動テストの場合は、セルフホスティングを使用します。つまり、WebView2 ランタイムのプレビュー バージョンをアプリと共にデプロイして、チームが毎日使用します。 現在の記事で取り上げる。

WebView2 のプレビュー チャネルをセルフホストする方法

Edge ブラウザーの開発チャネルでプレビュー WebView2 ランタイムを使用してセルフホストすることをお勧めします。 Dev チャネルは毎週更新されるため、毎日の使用に十分な安定性を持ちながら、問題を早期にキャッチできます。

カナリアチャンネルも適していますが、毎日の使用には安定性が低い場合があります。 ベータ チャネルを使用すると、安定に出荷しようとしているランタイムのバージョンに対してテストできますが、アプリケーションに対して十分な早い段階で問題をキャッチできない可能性があります。

WebView2 のプレビュー チャネルをセルフホストするには:

  1. アプリのプレビュー チャネルを設定します。

    ChannelSearchKind を使用してプレビュー チャネルを設定し、WebView2 アプリがデバイスで最小安定チャネルを使用できるようにすることができます。 自己ホスティングには、レジストリ キーまたはグループ ポリシーを使用することをお勧めします。

  2. チームのマシンにプレビュー チャネルをインストールします。

    少数のデバイスにプレビュー チャネルをインストールするには、[ Microsoft Edge Insider になる] ページから手動でダウンロードしてインストールできます。 多数のデバイスにプレビュー チャネルを展開するには、「今後の API と機能をテストする」の「プレビュー チャネルをデプロイする方法」を参照してください。

  3. WebView2 のプレビュー チャネルでアプリを毎日使用し、WebView2 ランタイムに関する潜在的な問題を診断します。

    以下の 「WebView2 ランタイムに関する潜在的な問題を診断する」を参照してください。

問題を見つけたら、 Microsoft Edge/WebView2Feedback リポジトリを使用して報告できます。 セクションの Runtime Channel 下で、プレビュー チャネルで問題が見つかったことを示して、バグが安定版リリースに付属する前に修正を優先できるようにします。

WebView2 ランタイムに関する潜在的な問題を診断する

アプリによって表示されるプレビュー WebView2 ランタイムの潜在的な問題を診断またはトラブルシューティングするには、次の手順を実行します。

アプリが WebView2 のプレビュー チャネルを実行していることを確認する

  1. Windows で、タスク マネージャーを開きます。

  2. アプリケーションのプロセスを見つけて、 WebView2 Manager の子プロセスを見つけます。

  3. Edge WebView2 プロセスを右クリックし、[ファイルの場所を開く] を選択します。 フォルダー名はランタイムのバージョン番号です。

安定した WebView2 ランタイム チャネルに切り替えて、問題が再現されているかどうかを確認する

問題が WebView2 ランタイムの安定チャネルで再現されていない場合、問題は WebView2 のプレビュー チャネル、またはアプリが WebView2 のプレビュー チャネルとどのように対話するかである可能性があります。

変更された環境変数はレジストリ設定 (グループ ポリシーによって設定される) をオーバーライドするため、 環境変数を使用して安定チャネル (エバーグリーン WebView2 ランタイム) に簡単に切り替えることができます。 これにより、プレビュー チャネルから安定したチャネルに簡単に切り替えて、問題が再現されているかどうかを確認できます。 環境変数を既に使用している場合は、値を更新するだけです。

環境変数をグローバルに設定すると、コンピューター上で WebView2 を使用するすべてのアプリの WebView2 チャネルが変更されます。

API を使用している場合は、アプリで UI を作成して、ユーザーが安定したランタイムまたはプレビュー ランタイムの使用を変更できるようにすることをお勧めします。

診断 データを収集する

  1. 「診断とログの収集」を参照してください。 Windows (ETW) トレースのクラッシュ ダンプとイベント トレースは、必要な一般的な形式です。

  2. その後、 問題を Microsoft Edge/WebView2Feedback リポジトリに報告し、ログ ファイルを含めることができます。

関連項目