次の方法で共有

WebView2 SDK のリリース ノート

  • [アーティクル]

これらのリリース ノートには、WebView2 リリース SDK と WebView2 プレリリース SDK に含まれる新機能とバグ修正に関する情報が記載されています。

1.0.3124.44

リリース日: 2025 年 3 月 10 日

WebView2 SDK 1.0.3124.44 用 NuGet パッケージ

完全な API 互換性のために、このリリース バージョンの WebView2 SDK には、WebView2 Runtime バージョン 134.0.3124.44 以降が必要です。

プロモーション

追加の API は Stable に昇格されておらず、このリリース SDK に追加されています。

バグ修正

ランタイムのみ
  • 開発者モードがオンかどうかに関係なく、 AddBrowserExtensionAsyncを使用して WebView2 で拡張機能が無効になりません。 (Issue #5113)
  • ネットワーク時刻のバックグラウンド更新を無効にしました。 (問題 #5047)
  • target="_blank"時にダウンロードポップアップが表示されない問題を修正しました。 (Issue #5063)

1.0.3171-prerelease

リリース日: 2025 年 3 月 10 日

WebView2 SDK 1.0.3171-prerelease 用 NuGet パッケージ

完全な API 互換性のために、このプレリリース バージョンの WebView2 SDK には、Microsoft Edge バージョン 135.0.3171.0 以降に付属する WebView2 ランタイムが必要です。

試験的な API

このプレリリース SDK には、試験的な API は追加されていません。

プロモーション

このプレリリース SDK では、試験的から安定版への API は昇格されていません。

バグ修正

ランタイムと SDK
  • ホスト オブジェクトの非同期メソッド例外処理を修正しました。 (Issue #3402)
  • CoreWebVIew2.Navigateのドキュメントを修正しました。 (Issue #5091)
ランタイムのみ
  • "Chrome に追加" ストアのインストールの回帰を修正しました。
  • UWP と WinUI でのフォルダーのアップロードを修正しました。 (問題 #3275)
  • 開発者モードがオンかどうかに関係なく、 AddBrowserExtensionAsyncを使用して WebView2 で拡張機能が無効になりません。 (Issue #5113)
  • ネットワーク時刻のバックグラウンド更新を無効にしました。 (問題 #5047)
  • target="_blank"時にダウンロードポップアップが表示されない問題を修正しました。 (Issue #5063)
SDK 専用
  • ガベージ コレクターが、メイン スレッド以外のスレッドでFinalizeを呼び出したときに発生する可能性があるクラッシュを修正します。

1.0.3065.39

リリース日: 2025 年 2 月 10 日

WebView2 SDK 1.0.3065.39 用 NuGet パッケージ

完全な API 互換性のために、このリリース バージョンの WebView2 SDK には、WebView2 Runtime バージョン 133.0.3065.39 以降が必要です。

プロモーション

追加の API は Stable に昇格されておらず、このリリース SDK に追加されています。

バグ修正

ランタイムのみ
  • [ダウンロード] ポップアップに不足している [閉じる] ボタンが追加されました。
  • Web 要求応答イベントが発生しない場合に発生する競合状態を修正しました。

1.0.3116-prerelease

リリース日: 2025 年 2 月 10 日

WebView2 SDK 1.0.3116-prerelease 用 NuGet パッケージ

完全な API 互換性のために、このプレリリース バージョンの WebView2 SDK には、Microsoft Edge バージョン 134.0.3116.0 以降に付属する WebView2 ランタイムが必要です。

試験的な API

このプレリリース SDK には、試験的な API は追加されていません。

プロモーション

このプレリリース SDK では、試験的から安定版への API は昇格されていません。

バグ修正

ランタイムのみ
  • [ダウンロード] ポップアップに不足している [閉じる] ボタンが追加されました。
  • Web 要求応答イベントが発生しない場合に発生する競合状態を修正しました。
SDK 専用
  • FindPreviousが正しく説明されていないCoreWebView2Find.FindNextメソッドの .NET および Win32 ドキュメントを修正しました。 メソッドの概要で、代わりに FindNext が説明されるようになりました。 (問題 #5059)

1.0.2957.106

リリース日: 2025 年 1 月 20 日

WebView2 SDK 1.0.2957.106 用 NuGet パッケージ

完全な API 互換性のために、このリリース バージョンの WebView2 SDK には、WebView2 Runtime バージョン 132.0.2957.106 以上が必要です。

プロモーション

次の API が Stable に昇格され、このリリース SDK に含まれるようになりました。

WebView2 レイヤーの上に WPF 要素を表示する (WebView2CompositionControl)

WebView2CompositionControlでは、WebView2 コントロールが WPF アプリの最上位レイヤーになり、WPF 要素を隠すのを防ぎます。 Microsoft.Web.WebView2.Wpf.WebView2CompositionControl は、標準の WPF WebView2 コントロールのドロップイン置換です。 WebView2 コントロールと WebView2CompositionControl の両方で、 Microsoft.Web.WebView2.Wpf.IWebView2 インターフェイスが実装されます。 どちらも、次のように FrameworkElementから派生します。

  • FrameworkElement ->HwndHost ->WebView2.
  • FrameworkElement ->Control ->WebView2CompositionControl.

背景: Windows Presentation Foundation (WPF) アプリをビルドし、WebView2 コントロールを使用している場合、WebView2 コントロールが常に上部に表示され、WEBView2 コントロールの上にある WPF 要素を指定しようとした場合でも (ビジュアル ツリーの順序または z-index プロパティを使用して) 同じ場所に WPF 要素を非表示にする "空域" の問題が発生することがあります。 例: )。

この問題は、WPF コントロールが WPF HwndHost を使用して Win32 WebView2 コントロールをホストし、 HwndHost 空き領域に問題があるために発生します。

関連項目:

バグ修正

ランタイムのみ
  • 表示の変更によって WebView2 がアプリ ウィンドウよりも小さくレンダリングされる可能性がある回帰を修正しました。
SDK 専用
  • ので初期化されたときなど、サイズ (0,0) で初期化されている場合に表示されない WPF の問題を修正しました。 (Issue #4941)

1.0.3079-prerelease

リリース日: 2025 年 1 月 24 日

WebView2 SDK 1.0.3079-prerelease 用 NuGet パッケージ

完全な API 互換性のために、このプレリリース バージョンの WebView2 SDK には、Microsoft Edge バージョン 134.0.3079.0 以降に付属する WebView2 ランタイムが必要です。

試験的な API

このプレリリース SDK には、次の試験的 API が追加されています。

検索動作をカスタマイズする (検索 API)

Find API を使用すると、プログラムによって 検索 操作を制御でき、アプリに次の機能を追加できます。

  • 検索の用語、大文字と小文字の区別、Word照合、一致の強調表示、既定の UI 抑制など、検索オプションをカスタマイズします。
  • テキスト文字列を検索し、WebView2 コントロール内でそれらの間を移動します。
  • プログラムによって 検索 操作を開始し、[結果の 検索] に移動します。
  • 既定の [UI の検索] を抑制します。
  • 検索操作の状態を追跡します。

PDF ドキュメントの検索 API には既知の問題があります。 WebView2 コントロール内で PDF ドキュメントを表示する場合、 現在、検索 機能は最初のインデックスと一致する検索の数のみを提供します。 たとえば、文字列が PDF で 3 回発生する場合、UI は 1/3 と表示され、プログラムによる Next または Previous の呼び出しはサポートされません。 これらの問題は積極的に調査しています。 WebView2Feedback リポジトリを使用して、発生した問題を報告することをお勧めします。

ドラッグ アンド ドロップの動作をカスタマイズする (DragStarting API)

DragStarting API は、ビジュアル ホスティング モードで実行されている場合の既定のドラッグ アンド ドロップ動作をオーバーライドします。 DragStarting イベントは、ユーザーが WebView2 でドラッグ操作を開始したときにアプリに通知し、既定の WebView2 ドラッグ操作を独自のロジックでオーバーライドするために必要な状態を提供します。

  • ドラッグ操作の開始時に呼び出されるイベント ハンドラーを追加するには、ICoreWebView2ExperimentalCompositionController6でDragStartingを使用します。
  • ICoreWebView2ExperimentalDragStartingEventArgsを使用して、独自のドラッグ操作を開始します。
    • 非同期ドラッグ ロジックを実行し、後で WebView にコールバックするには、 GetDeferral メソッドを使用します。
    • Handled プロパティを使用して、WebView2 に独自のドラッグ ロジックを使用するかどうかを知らせます。
入れ子になった iframe のナビゲーション履歴を追跡する (FrameCreatedEvent API)

FrameCreatedEvent API では、2 番目のレベルの iframe のナビゲーション履歴の記録など、入れ子になった iframe がサポートされています。 この API がないと、WebView2 は、メイン フレームの直接の子 iframe である第 1 レベルの iframe のみを追跡します。 この API を使用すると、アプリは入れ子になった iframe 作成イベントをサブスクライブして、入れ子になった iframe の CoreWebView2Frame のすべてのプロパティ、メソッド、イベントにアプリにアクセスできます。

この API を使用して、複数のレベルの iframe を含むページで iframe 追跡を管理します。 次のいずれかを追跡できます。

  • メイン ページと最初のレベルの iframe (既定の動作) のみ。
  • 特定の iframe が対象の部分 WebView2 フレーム ツリー。
  • 完全な WebView2 フレーム ツリー。
WebView2 の初期化で既定の背景色を設定する (DefaultBackgroundColor API)

DefaultBackgroundColor API を使用すると、ユーザーは初期化時に DefaultBackgroundColor プロパティを設定できます。 これにより、WebView2 の読み込みプロセス中に白いフラッシュが中断されるのを防ぎます。

プロモーション

このプレリリース SDK では、次の API が試験的から安定版に昇格されています。

WebView2 レイヤーの上に WPF 要素を表示する (WebView2CompositionControl)

WebView2CompositionControlでは、WebView2 コントロールが WPF アプリの最上位レイヤーになり、WPF 要素を隠すのを防ぎます。 Microsoft.Web.WebView2.Wpf.WebView2CompositionControl は、標準の WPF WebView2 コントロールのドロップイン置換です。 WebView2 コントロールと WebView2CompositionControl の両方で、 Microsoft.Web.WebView2.Wpf.IWebView2 インターフェイスが実装されます。 どちらも、次のように FrameworkElementから派生します。

  • FrameworkElement ->HwndHost ->WebView2.
  • FrameworkElement ->Control ->WebView2CompositionControl.

背景: Windows Presentation Foundation (WPF) アプリをビルドし、WebView2 コントロールを使用している場合、WebView2 コントロールが常に上部に表示され、WEBView2 コントロールの上にある WPF 要素を指定しようとした場合でも (ビジュアル ツリーの順序または z-index プロパティを使用して) 同じ場所に WPF 要素を非表示にする "空域" の問題が発生することがあります。 例: )。

この問題は、WPF コントロールが WPF HwndHost を使用して Win32 WebView2 コントロールをホストし、 HwndHost 空き領域に問題があるために発生します。

関連項目:

バグ修正

ランタイムのみ
  • 表示の変更によって WebView2 がアプリ ウィンドウよりも小さくレンダリングされる可能性がある回帰を修正しました。
  • WebView2 の IsolateSandboxedIframes アップストリーム機能を有効にしました。
  • バージョンが変更されたときにサービス ワーカーを削除できない。
  • HostobjectのCleanUpSome API では、完全なヒープのガベージ コレクションのみが実行されるようになりました。 CleanUpSome V8 エンジンから取り外されました。
  • AreBrowserAcceleratorKeysEnabledの回帰を修正しました。 (Issue #5033)
  • キーボードを使用してダイアログを閉じると IsDefaultDownloadDialogOpenChanged がトリガーされないバグを修正しました。 (Issue #4807)
SDK 専用
  • ので初期化されたときなど、サイズ (0,0) で初期化されている場合に表示されない WPF の問題を修正しました。 (Issue #4941)

1.0.2903.40

リリース日: 2024 年 11 月 18 日

WebView2 SDK 1.0.2903.40 用 NuGet パッケージ

完全な API 互換性のために、このリリース バージョンの WebView2 SDK には、WebView2 Runtime バージョン 131.0.2903.40 以降が必要です。

プロモーション

次の API が Stable に昇格され、このリリース SDK に含まれるようになりました。

画面キャプチャ UI を表示するかどうかを制御する (ScreenCaptureStarting イベント)

新しい ScreenCaptureStarting イベントを追加しました。 このイベントは、UI が表示される前に、 CoreWebView2Frame (またはその子孫の iframe) に対応する WebView2 または iframe が Screen Capture API を使用するアクセス許可を要求するたびに発生します。 その後、アプリは UI の表示をブロックしたり、UI の表示を許可したりできます。

バグ修正

ランタイムのみ
  • [ ダウンロード ] ダイアログが起動時に最初のフォーカスを受け取ることを許可しました。

一般的な変更

  • Microsoft Edge WebView2 ランタイムは、永続的なシステム コンポーネントであるため、Windows 設定>Apps>Installed アプリには表示されなくなります。

1.0.2950-prerelease

リリース日: 2024 年 11 月 18 日

WebView2 SDK 1.0.2950-prerelease 用 NuGet パッケージ

完全な API 互換性のために、このプレリリース バージョンの WebView2 SDK には、Microsoft Edge バージョン 132.0.2950.0 以降に付属する WebView2 ランタイムが必要です。

試験的な API

このプレリリース SDK には、試験的な API は追加されていません。

プロモーション

このプレリリース SDK では、試験的から安定版への API は昇格されていません。

バグ修正

ランタイムのみ
  • [ ダウンロード ] ダイアログが起動時に最初のフォーカスを受け取ることを許可しました。
  • FrameNavigationStartingの特定のサイトへのナビゲーションをキャンセル中のクラッシュを修正しました。 (Issue #4843)
  • タッチ選択メニューが表示されているときにコンテキスト メニューのカスタマイズを延期しました。 (Issue #4737)
SDK 専用
  • Arm64ec のサポートを追加しました。
  • "Window to Visual" モードで実行されている WebView2 がアクセラレータ入力を受信できない問題を修正しました。

1.0.2849.39

リリース日: 2024 年 10 月 21 日

WebView2 SDK 1.0.2849.39 用 NuGet パッケージ

完全な API 互換性のために、このリリース バージョンの WebView2 SDK には、WebView2 Runtime バージョン 130.0.2849.39 以降が必要です。

プロモーション

次の API が Stable に昇格され、このリリース SDK に含まれるようになりました。

ファイルを保存するときにセキュリティ警告を構成する (SaveFileSecurityCheckStarting イベント)

新しい SaveFileSecurityCheckStarting イベントを追加しました。 アプリでは、このイベントにハンドラーを登録して、ファイル パス、ファイル名拡張子、ドキュメントの配信元 URI 情報を取得できます。 その後、独自のルールを適用して、次のようなアクションを実行できます。

  • ファイルの種類のポリシーに関する既定のセキュリティ警告 UI を表示せずに、ファイルの保存を許可します。
  • 保存を取り消します。
  • ランタイム ファイルの種類のポリシーを管理するための独自の UI を作成します。

バグ修正

ランタイムのみ
  • Tab キーまたは Shift キーを押しながら Tab キーを押して Webview2 コントロールに切り替えるときのダウンロード ダイアログ フォーカスの問題を修正しました。
SDK 専用
  • CoreWebView2WebResourceRequestSourceKinds パラメーターなしでCoreWebView2.AddWebResourceRequestedFilterを使用することは非推奨になりました。 .NET CoreWebView2.AddWebResourceRequestedFilter メソッドを参照してください。
  • C# WinRT 用の .NET 8 TargetFramework を追加し、AOT (事前に) 互換性を有効にし、ランタイム マーシャリングを無効にしました。

1.0.2895-prerelease

リリース日: 2024 年 10 月 21 日

WebView2 SDK 1.0.2895-prerelease 用 NuGet パッケージ

完全な API 互換性のために、このプレリリース バージョンの WebView2 SDK には、Microsoft Edge バージョン 131.0.2895.0 以降に付属する WebView2 ランタイムが必要です。

試験的な API

このプレリリース SDK には、次の試験的 API が追加されています。

RestartRequested WebView2 を再起動する必要がある場合のイベント

新しい RestartRequested イベントを追加しました。 RestartRequested イベントは、更新プログラムまたは構成の変更を適用するために WebView2 を再起動する必要があるときに発生します。 この API を使用して、WebView2 を再起動する必要があるタイミングを検出し、適切なアクションを実行できます。 RestartRequested イベント引数の Priority プロパティは、再起動要求の優先順位を示します。

  • High は、アプリができるだけ早く再起動するようにユーザーに求めるメッセージを表示します。
  • Normal は、アプリがベスト エフォートベースでユーザーに再起動を通知する必要があることを示します。

プロモーション

このプレリリース SDK では、次の API が試験的から安定版に昇格されています。

画面キャプチャ UI を表示するかどうかを制御する (ScreenCaptureStarting イベント)

新しい ScreenCaptureStarting イベントを追加しました。 このイベントは、UI が表示される前に、 CoreWebView2Frame (またはその子孫の iframe) に対応する WebView2 または iframe が Screen Capture API を使用するアクセス許可を要求するたびに発生します。 その後、アプリは UI の表示をブロックしたり、UI の表示を許可したりできます。

ファイルを保存するときにセキュリティ警告を構成する (SaveFileSecurityCheckStarting イベント)

新しい SaveFileSecurityCheckStarting イベントを追加しました。 アプリでは、このイベントにハンドラーを登録して、ファイル パス、ファイル名拡張子、ドキュメントの配信元 URI 情報を取得できます。 その後、独自のルールを適用して、次のようなアクションを実行できます。

  • ファイルの種類のポリシーに関する既定のセキュリティ警告 UI を表示せずに、ファイルの保存を許可します。
  • 保存を取り消します。
  • ランタイム ファイルの種類のポリシーを管理するための独自の UI を作成します。

バグ修正

SDK 専用
  • WindowsAppSDK 1.6 での Arm64 非互換性を修正しました。
  • WinAppSDK ケースの追加の WebView2Loader.dll を削除しました。
  • CoreWebView2WebResourceRequestSourceKinds パラメーターなしでCoreWebView2.AddWebResourceRequestedFilterを使用することは非推奨になりました。 .NET CoreWebView2.AddWebResourceRequestedFilter メソッドを参照してください。

関連項目