WebView2 SDK のリリース ノート
これらのリリース ノートには、WebView2 リリース SDK と WebView2 プレリリース SDK に含まれる新機能とバグ修正に関する情報が記載されています。
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 の表示を許可したりできます。
CoreWebView2
クラス:CoreWebView2Frame
クラス:CoreWebView2NonClientRegionKind
列挙型:
バグ修正
ランタイムのみ
- [ ダウンロード ] ダイアログが起動時に最初のフォーカスを受け取ることを許可しました。
一般的な変更
- 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 を作成します。
CoreWebView2
クラス:CoreWebView2SaveFileSecurityCheckStartingEventArgs クラス
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave プロパティ
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri プロパティ
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension プロパティ
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath プロパティ
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy プロパティ
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral メソッド
バグ修正
ランタイムのみ
- 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
は、アプリがベスト エフォートベースでユーザーに再起動を通知する必要があることを示します。
CoreWebView2Environment
クラス:CoreWebView2RestartRequestedEventArgs
クラス:CoreWebView2RestartRequestedPriority 列挙型
CoreWebView2RestartRequestedPriority.Normal
CoreWebView2RestartRequestedPriority.High
プロモーション
このプレリリース SDK では、次の API が試験的から安定版に昇格されています。
画面キャプチャ UI を表示するかどうかを制御する (ScreenCaptureStarting
イベント)
新しい ScreenCaptureStarting
イベントを追加しました。 このイベントは、UI が表示される前に、 CoreWebView2Frame
(またはその子孫の iframe) に対応する WebView2 または iframe が Screen Capture API を使用するアクセス許可を要求するたびに発生します。 その後、アプリは UI の表示をブロックしたり、UI の表示を許可したりできます。
CoreWebView2
クラス:CoreWebView2Frame
クラス:CoreWebView2ScreenCaptureStartingEventArgs
クラス:
ファイルを保存するときにセキュリティ警告を構成する (SaveFileSecurityCheckStarting
イベント)
新しい SaveFileSecurityCheckStarting
イベントを追加しました。 アプリでは、このイベントにハンドラーを登録して、ファイル パス、ファイル名拡張子、ドキュメントの配信元 URI 情報を取得できます。 その後、独自のルールを適用して、次のようなアクションを実行できます。
- ファイルの種類のポリシーに関する既定のセキュリティ警告 UI を表示せずに、ファイルの保存を許可します。
- 保存を取り消します。
- ランタイム ファイルの種類のポリシーを管理するための独自の UI を作成します。
CoreWebView2
クラス:CoreWebView2SaveFileSecurityCheckStartingEventArgs クラス
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave プロパティ
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri プロパティ
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension プロパティ
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath プロパティ
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy プロパティ
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral メソッド
バグ修正
SDK 専用
- WindowsAppSDK 1.6 での Arm64 非互換性を修正しました。
- WinAppSDK ケースの追加の
WebView2Loader.dll
を削除しました。 -
CoreWebView2WebResourceRequestSourceKinds
パラメーターなしでCoreWebView2.AddWebResourceRequestedFilter
を使用することは非推奨になりました。 .NET CoreWebView2.AddWebResourceRequestedFilter メソッドを参照してください。
1.0.2792.45
リリース日: 2024 年 9 月 23 日
WebView2 SDK 1.0.2792.45 用 NuGet パッケージ
完全な API 互換性のために、このリリース バージョンの WebView2 SDK には、WebView2 Runtime バージョン 129.0.2792.45 以降が必要です。
プロモーション
追加の API は Stable に昇格されておらず、このリリース SDK に追加されています。
バグ修正
SDK 専用
- .NET プロジェクトの SDK 依存関係を修正しました。 (問題 #4743)
1.0.2839-prerelease
リリース日: 2024 年 9 月 23 日
WebView2 SDK 1.0.2839-prerelease 用 NuGet パッケージ
完全な API 互換性のために、このプレリリース バージョンの WebView2 SDK には、Microsoft Edge バージョン 130.0.2839.0 以降に付属する WebView2 ランタイムが必要です。
試験的な API
このプレリリース SDK には、試験的な API は追加されていません。
プロモーション
このプレリリース SDK では、試験的から安定版への API は昇格されていません。
バグ修正
ランタイムのみ
- Windows の [非アクティブなウィンドウのスクロール] 設定が無効になっている WinAppSDK の WebView2 コントロールに焦点を当てると、スクロールが失敗する問題を修正しました。
- WebView2 でブロックされた
edge://wallet
。 (Issue #4710) - コントローラーの作成が完了した後、.NET WebView2 コントロールの既定の背景色の環境変数をクリアしました。
- ビジュアル ホスティング モードでの Webview2 のアクセシビリティサポートを有効にしました。
- 複数のソースの "Web リソースが要求された" フィルターを削除するバグを修正しました(そのうちの 1 つが Document の場合)。
- WinUI または他の視覚的にホストされた WebView2 インスタンスで
DataList
が表示されない回帰を修正しました。
SDK 専用
- .NET プロジェクトの SDK 依存関係を修正しました。 (問題 #4743)
- 古い
WebView2Loader.dll
でGetAvailableBrowserVersionString()
を呼び出すときの互換性の問題を修正しました。 (Issue #4395) -
cpp20
オプションと/permissive-
オプションを使用して wv2winrt で生成されたコードをコンパイルするときの問題を修正しました。 - C# WinRT 用の .NET 8
TargetFramework
を追加し、AOT (事前に) 互換性を有効にし、ランタイム マーシャリングを無効にしました。
1.0.2739.15
リリース日: 2024 年 8 月 26 日
WebView2 SDK 1.0.2739.15 用 NuGet パッケージ
完全な API 互換性のために、このリリース バージョンの WebView2 SDK には、WebView2 Runtime バージョン 128.0.2739.15 以降が必要です。
プロモーション
次の API が Stable に昇格され、このリリース SDK に含まれるようになりました。
Web 通知処理
非永続的な通知の Web 通知のサポートを追加しました。
CoreWebView2
のNotificationReceived
イベントは、Web 通知処理を制御し、ホスト アプリによるカスタマイズまたは抑制を可能にします。 未処理の通知は、既定で WebView2 の UI に設定されます。
CoreWebView2
クラス:-
- CoreWebView2Notification.BadgeUri プロパティ
- CoreWebView2Notification.Body プロパティ
- CoreWebView2Notification.BodyImageUri プロパティ
- CoreWebView2Notification.Direction プロパティ
- CoreWebView2Notification.IconUri プロパティ
- CoreWebView2Notification.IsSilent プロパティ
- CoreWebView2Notification.Language プロパティ
- CoreWebView2Notification.RequiresInteraction プロパティ
- CoreWebView2Notification.ShouldRenotify プロパティ
- CoreWebView2Notification.Tag プロパティ
- CoreWebView2Notification.Timestamp プロパティ
- CoreWebView2Notification.Title プロパティ
- CoreWebView2Notification.VibrationPattern プロパティ
- CoreWebView2Notification.ReportClicked メソッド
- CoreWebView2Notification.ReportClosed メソッド
- CoreWebView2Notification.ReportShown メソッド
- CoreWebView2Notification.CloseRequested イベント
CoreWebView2TextDirectionKind 列挙型
Default
LeftToRight
RightToLeft
[名前を付けて保存]
プログラムSaveAs
名前を付けて保存操作を実行できる API を追加しました。 これらの API を使用して、既定の [名前を付けて保存] ダイアログをブロックし、サイレント 形式で保存するか、[ 名前を付けて保存] 用に独自の UI を作成できます。 これらの API は、[ 名前を付けて保存] ダイアログにのみ関連します。既存の ダウンロード API を引き続き使用する [ダウンロード] ダイアログには関係しません。
CoreWebView2
クラス:-
Complete
Default
HtmlOnly
SingleFile
CoreWebView2SaveAsUIResult 列挙型
Cancelled
FileAlreadyExists
InvalidPath
KindNotSupported
Success
CoreWebView2SaveAsUIShowingEventArgs クラス
- CoreWebView2SaveAsUIShowingEventArgs.AllowReplace プロパティ
- CoreWebView2SaveAsUIShowingEventArgs.Cancel プロパティ
- CoreWebView2SaveAsUIShowingEventArgs.ContentMimeType プロパティ
- CoreWebView2SaveAsUIShowingEventArgs.Kind プロパティ
- CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath プロパティ
- CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog プロパティ
- CoreWebView2SaveAsUIShowingEventArgs.GetDeferral メソッド
バグ修正
このリリース SDK にはバグ修正はありません。
1.0.2783-prerelease
リリース日: 2024 年 8 月 26 日
WebView2 SDK 1.0.2783-prerelease 用 NuGet パッケージ
完全な API 互換性のために、このプレリリース バージョンの WebView2 SDK には、Microsoft Edge バージョン 129.0.2783.0 以降に付属する WebView2 ランタイムが必要です。
試験的な API
このプレリリース SDK には、試験的な API は追加されていません。
プロモーション
このプレリリース SDK では、試験的から安定版への API は昇格されていません。
バグ修正
ランタイムと SDK
-
SetUserAgent
の既定の動作を再度有効にします。既定では、SetUserAgent
はクロスオリジン iframe に対して有効です。
ランタイムのみ
既定で対話型ドラッグ機能を有効にしました。 WebView2 ブラウザー フラグの
edge-webview-interactive-dragging
を参照してください。WebView2 の
IsolateSandboxedIframes
を無効にしました。複数のインスタンスが同時に起動されると WebView の作成が失敗する問題を修正しました。 (Issue #4731)
名前に
Proxy
またはFunction
が含まれるオブジェクトの既存のプロパティをキャッシュすると、名前の競合が原因でエラーが発生する WinRT JavaScript プロジェクションのバグを修正しました。モニターの切断と再接続後に WebView2 コントロールのサイズが間違っていたバグを修正しました。
"mailto:" リンクが自動的にポップアップ ウィンドウを閉じるのではなく、無題のポップアップ ウィンドウが開いたままになる問題を修正しました。
SDK 専用
C# WinRT プロジェクションが UWP で動作するようになりました。
Visual Studio for C# WinRT プロジェクションに
GeneratedFilesDir
が表示されなくなる問題を修正しました。
1.0.2651.64
リリース日: 2024 年 8 月 13 日
WebView2 SDK 1.0.2651.64 用 NuGet パッケージ
完全な API 互換性のために、このリリース バージョンの WebView2 SDK には、WebView2 Runtime バージョン 127.0.2651.64 以降が必要です。
プロモーション
次の API が Stable に昇格され、このリリース SDK に含まれるようになりました。
- WebMessageObjects API を更新し、アプリを介して構築された WebView2 コンテンツに DOM オブジェクトを挿入できるようにし、
CoreWebView2.PostWebMessage
API を介して他の方向に作成できるようにしました。 ファイル システム へのアクセスを提供するために Web コンテンツに投稿できるファイル システム ハンドルを表す新しい Web オブジェクトの種類 (CoreWebView2FileSystemHandle
) を追加しました。
CoreWebView2
クラス:CoreWebView2Environment
クラス:CoreWebView2FileSystemHandle
クラス:CoreWebView2FileSystemHandleKind 列挙型
File
Directory
CoreWebView2FileSystemHandlePermission 列挙型
ReadOnly
ReadWrite
バグ修正
ランタイムのみ
- 特定のサイトで
WebResourceRequested
イベントがクラッシュする回帰を修正しました。 (Issue #4602)
SDK 専用
- WinRT C# プロジェクションの x86 を修正しました。
1.0.2730-prerelease
リリース日: 2024 年 8 月 7 日
WebView2 SDK 1.0.2730-prerelease 用 NuGet パッケージ
完全な API 互換性のために、このプレリリース バージョンの WebView2 SDK には、Microsoft Edge バージョン 128.0.2730.0 以降に付属する WebView2 ランタイムが必要です。
試験的な API
このプレリリース SDK には、次の試験的 API が追加されています。
- JavaScript タイマーを調整できるようにすることで、効率的なリソース管理を可能にする新しい調整コントロール API を追加しました。 これは、WebView2 コントロールを表示したままにする必要があるが、(ユーザーがコンテンツを操作していない場合など) リソースを消費する必要があるシナリオで役立ちます。 これらの調整コントロール API を使用すると、次の操作を実行できます。
- さまざまなページ状態 (前景、背景、および集中的な調整を伴うバックグラウンド) で、スクリプト タイマー (
setTimeout
とsetInterval
) の調整をカスタマイズします。 - 選択したホストされた iframe でスクリプト タイマーを調整します。
- さまざまなページ状態 (前景、背景、および集中的な調整を伴うバックグラウンド) で、スクリプト タイマー (
CoreWebView2Frame
クラス:CoreWebView2Settings
クラス:
プロモーション
このプレリリース SDK では、次の API が試験的から安定版に昇格されています。
- プログラム
SaveAs
名前を付けて保存操作を実行できる API を追加しました。 これらの API を使用して、既定の [名前を付けて保存] ダイアログをブロックし、サイレント 形式で保存するか、[ 名前を付けて保存] 用に独自の UI を作成できます。 これらの API は、[ 名前を付けて保存] ダイアログにのみ関連します。既存の ダウンロード API を引き続き使用する [ダウンロード] ダイアログには関係しません。
CoreWebView2
クラス:-
Default
HtmlOnly
SingleFile
Complete
CoreWebView2SaveAsUIResult 列挙型
Success
InvalidPath
FileAlreadyExists
KindNotSupported
Cancelled
CoreWebView2SaveAsUIShowingEventArgs クラス
- CoreWebView2SaveAsUIShowingEventArgs.AllowReplace プロパティ
- CoreWebView2SaveAsUIShowingEventArgs.Cancel プロパティ
- CoreWebView2SaveAsUIShowingEventArgs.ContentMimeType プロパティ
- CoreWebView2SaveAsUIShowingEventArgs.Kind プロパティ
- CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath プロパティ
- CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog プロパティ
- CoreWebView2SaveAsUIShowingEventArgs.GetDeferral メソッド
- 非永続的な通知の Web 通知のサポートを追加しました。
CoreWebView2
のNotificationReceived
イベントは、Web 通知処理を制御し、ホスト アプリによるカスタマイズまたは抑制を可能にします。 未処理の通知は、既定で WebView2 の UI に設定されます。
バグ修正
ランタイムのみ
フォーカスが WebView2 for Visual ホスティング モードのとき、システム コマンド ( Alt + F4 や Alt + Space キーなど) を使用してアプリ ウィンドウを制御できない問題を修正しました。 (Issue #2961)
ホスト アプリから [検索] バーをクリックできない WebView2 UWP のバグを修正しました。
SDK 専用
不足している WinRT
CoreWebView2Notification.VibrationPattern
API の追加。 この WinRT API は、安定した通知 API プロモーションリリース ノートと組み合わせることができます。「Web 通知」を参照し、WinRT のNotificationReceived
を参照してください。すぐ上にあります。WinForms WebView2 コントロールの
KeyDown
イベントに正しいModifierKeys
情報が含まれていない問題を修正しました。 (問題 #1216)WinRT C# プロジェクションの x86 を修正しました。
ランタイムの更新中に
CreateCoreWebView2Environment
とGetAvailableCoreWebView2BrowserVersionString
潜在的な競合状態に対してより堅牢になりました。
関連項目
- WebView2 SDK のリリース ノートについて
- WebView2 SDK のアーカイブされたリリース ノート
- WebView2 API の概要 - リリース SDK パッケージにある多くの API の概要を機能領域別に示します。
- Microsoft Edge WebView2 チームへの問い合わせ