共用方式為

WebView2 SDK 版本的存檔釋出說明

這些版本說明提供了關於 WebView2 Release SDK 及 WebView2 預發布 SDK 中新增的功能與錯誤修正資訊，適用於較舊版本。

1.0.3296.44

上映日期：2025年6月3日

NuGet package for WebView2 SDK 1.0.3296.44

為了完全 API 相容，本版本的 WebView2 SDK 需要 WebView2 執行時版本 137.0.3296.44 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

在 WebView2 初始化時設定預設背景色 (DefaultBackgroundColor API)

DefaultBackgroundColor API 允許使用者在初始化時設定該 DefaultBackgroundColor 屬性。 這可避免在 WebView2 載入過程中出現干擾性的白光閃爍。

Bug 修正

僅執行時
  • 修正了印刷版PDF的邊界。

1.0.3344-預發布

上映日期：2025年6月3日

NuGet 套件 for WebView2 SDK 1.0.3344-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 138.0.3344.0 或更高版本所附的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

本預發布 SDK 中未新增任何實驗性 API。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

允許輸入事件訊息通過瀏覽器視窗

該 CoreWebView2ControllerOptions 類別現在有一個 AllowHostInputProcessing 屬性，允許使用者輸入事件訊息 (鍵盤、滑鼠、觸控或筆) ，透過瀏覽器視窗傳遞，並由應用程式的程序視窗接收。

Bug 修正

僅執行時
  • 修正了一個滑鼠事件在觸控事件後不會觸發的錯誤。
  • 已停用 WebView2 控制項的網頁擷取功能。
  • 修正了 下載 對話框。
  • 修正了預設瀏覽器幀下載的問題。 (第#5196號)
  • 修正了印刷版PDF的邊界。

1.0.3240.44

上映日期：2025年5月5日

NuGet package for WebView2 SDK 1.0.3240.44

為了完整 API 相容性，本版本的 WebView2 SDK 需要 WebView2 執行時版本 136.0.3240.44 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

追蹤巢狀 iframes 的導航歷史 (FrameCreatedEvent API)

FrameCreatedEvent API 支援巢狀 iframe，例如記錄二級 iframe 的導航歷史。 若無此 API，WebView2 僅追蹤第一層級 iframe，即主框架的直接子 iframe。 透過這個 API，你的應用程式可以訂閱巢狀 iframe 建立事件，讓應用程式能存取巢狀 iframe 的所有 CoreWebView2Frame 屬性、方法和事件。

使用此 API 管理包含多層 iframe 的頁面上的 iframe 追蹤。 您可以選擇追蹤以下任一項：

  • 只有主頁和第一層的 iframe (預設行為) 。
  • 一個部分 WebView2 框架樹，包含特定的感興趣 iframe。
  • 完整的 WebView2 框架樹。

Bug 修正

僅執行時
  • 修正了預設瀏覽器框架內下載無法完成的問題。 (第#5196號)
  • 修正了管道名稱錯誤回傳的問題，導致部分 UWP 應用程式當機。

1.0.3296-預發布

上映日期：2025年5月12日

NuGet 套件 for WebView2 SDK 1.0.3296-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 137.0.3296.0 或更高版本所附的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

本預發布 SDK 中未新增任何實驗性 API。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

在 WebView2 初始化時設定預設背景色 (DefaultBackgroundColor API)

DefaultBackgroundColor API 允許使用者在初始化時設定該 DefaultBackgroundColor 屬性。 這可避免在 WebView2 載入過程中出現干擾性的白光閃爍。

Bug 修正

僅執行時
  • 修正了視窗移動後 搜尋條不再 出現的問題。
  • 修正了一個 App 無法取消活動登入頁面 NavigationStarting 導航的錯誤。
  • 修正了預設瀏覽器框架內下載無法完成的問題。 (第#5196號)
  • 修正了管道名稱錯誤回傳的問題，導致部分 UWP 應用程式當機。

1.0.3179.45

上映日期：2025年4月7日

NuGet 套件 for WebView2 SDK 1.0.3179.45

為了完整 API 相容性，本版本的 WebView2 SDK 需要 WebView2 執行時版本 135.0.3179.45 或更高。

第三階段 (穩定版)

在本版本 SDK 中，尚未將 API 從預發布階段的第二階段穩定升級為第三階段：穩定發布階段。

Bug 修正

僅執行時
  • 修正了 WordPress 應用程式中 HTML Select 元素 (<選擇>) 讓它可選。
  • 在 WebView2 控制範圍內固定導航 edge://crashes 。
  • 修正了從 WebView2 實例呼叫 Windows 憑證介面時可能的當機與介面問題。
  • 修正了一個用戶無法輸入帶有自動填充資訊的輸入欄位的錯誤。 (第#5144期)

1.0.3230-預釋版本

上映日期：2025年4月7日

NuGet 套件 for WebView2 SDK 1.0.3230-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 136.0.3230.0 或更高版本所附的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

本預發布 SDK 中未新增任何實驗性 API。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

追蹤巢狀 iframes 的導航歷史 (FrameCreatedEvent API)

FrameCreatedEvent API 支援巢狀 iframe，例如記錄二級 iframe 的導航歷史。 若無此 API，WebView2 僅追蹤第一層級 iframe，即主框架的直接子 iframe。 透過這個 API，你的應用程式可以訂閱巢狀 iframe 建立事件，讓應用程式能存取巢狀 iframe 的所有 CoreWebView2Frame 屬性、方法和事件。

使用此 API 管理包含多層 iframe 的頁面上的 iframe 追蹤。 您可以選擇追蹤以下任一項：

  • 只有主頁和第一層的 iframe (預設行為) 。
  • 一個部分 WebView2 框架樹，包含特定的感興趣 iframe。
  • 完整的 WebView2 框架樹。

Bug 修正

僅執行時
  • 修正了 WPF <中當滑鼠移出 WebView2 控制範圍時，資料清單> 下拉選單關閉的問題。
  • 在 WebView2 控制範圍內固定導航 edge://crashes 。
  • 修正了 WordPress 應用程式中 HTML Select 元素 (<選擇>) 讓它可選。
  • 修正了從 WebView2 實例呼叫 Windows 憑證介面時可能的當機與介面問題。
  • 已修正使用者無法在輸入欄位輸入自動填入資訊的錯誤。 (第#5144期)
  • 修正了 狀態列 API 的回歸問題。
僅限 SDK
  • 在視窗到視覺主機模式下，固定了 Tab、 Shift+Tab 和 方向 鍵。

1.0.3124.44

上映日期：2025年3月10日

NuGet package for WebView2 SDK 1.0.3124.44

為完整 API 相容性，此版本的 WebView2 SDK 需 WebView2 執行時版本 134.0.3124.44 或更高版本。

第三階段 (穩定版)

在本版本 SDK 中，尚未將 API 從預發布階段的第二階段穩定升級為第三階段：穩定發布階段。

Bug 修正

僅執行時
  • 在 WebView2 中，使用 AddBrowserExtensionAsync、 不論開發者模式是否開啟，擴充功能都不會被停用。 (第#5113期)
  • 關閉網路時間的背景更新。 (第#5047號)
  • 修正了下載彈出視窗在 target="_blank". (第#5063號)

1.0.3171-預釋版本

上映日期：2025年3月10日

NuGet 套件for WebView2 SDK 1.0.3171-prerelease

為了完整 API 相容性，此預發布版 WebView2 SDK 需要隨 Microsoft Edge 版本 135.0.3171.0 或更高版本附帶的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

本預發布 SDK 中未新增任何實驗性 API。

預發行 (階段穩定版的推廣)

在此預發布 SDK 中，尚未將任何 API 從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段。

Bug 修正

執行環境與 SDK
  • 固定主機物件非同步方法的異常處理。 (第#3402號)
  • 固定文件。CoreWebVIew2.Navigate (第#5091號)
僅執行時
  • 修正了「新增到 Chrome」商店安裝的倒退問題。
  • 修正了 UWP 和 WinUI 的資料夾上傳問題。 (第#3275號)
  • 在 WebView2 中，使用 AddBrowserExtensionAsync、 不論開發者模式是否開啟，擴充功能都不會被停用。 (第#5113期)
  • 關閉網路時間的背景更新。 (第#5047號)
  • 修正了下載彈出視窗在 target="_blank". (第#5063號)
僅限 SDK
  • 修復了垃圾回收 Finalize 器呼叫主執行緒以外的執行緒時可能發生的當機。

1.0.3065.39

上映日期：2025年2月10日

NuGet package for WebView2 SDK 1.0.3065.39

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 133.0.3065.39 或更高版本。

第三階段 (穩定版)

在本版本 SDK 中，尚未將 API 從預發布階段的第二階段穩定升級為第三階段：穩定發布階段。

Bug 修正

僅執行時
  • 在下載介面中新增了缺少的關閉按鈕。
  • 修正了當網路請求回應事件從未發生時所發生的競賽狀況。

1.0.3116-預釋版本

上映日期：2025年2月10日

NuGet 套件用於 WebView2 SDK 1.0.3116-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 134.0.3116.0 或更高版本所附的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

本預發布 SDK 中未新增任何實驗性 API。

預發行 (階段穩定版的推廣)

在此預發布 SDK 中，尚未將任何 API 從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段。

Bug 修正

僅執行時
  • 在下載介面中新增了缺少的關閉按鈕。
  • 修正了當網路請求回應事件從未發生時所發生的競賽狀況。
僅限 SDK
  • 修正了 .NET 和 Win32 文件 CoreWebView2Find.FindNext 中錯誤提及 FindPrevious的方法。 方法摘要現在提到 FindNext 了。 (第#5059期)

1.0.2957.106

上映日期：2025年1月20日

NuGet package for WebView2 SDK 1.0.2957.106

為完整 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 132.0.2957.106 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 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 控制項總是顯示在最上方，導致任何 WPF 元素都被隱藏在同一位置，即使你嘗試用視覺樹狀順序或 z-index 屬性，將 WPF 元素設定在 WebView2 控制項之上， (例如) 。

此問題發生是因為 WPF 控制使用該 WPF HwndHost 來承載 Win32 WebView2 控制項，且 HwndHost 存在空域問題。

另請參閱:

Bug 修正

僅執行時
  • 修正了一個迴歸問題，顯示變更可能導致 WebView2 渲染得比應用程式視窗還小。
僅限 SDK
  • 修正了 WPF WebView2CompositionControl 中一個問題，當初始化時大小為 0,0 () ，例如初始化為 TabItem a 或 TabControl。 (第4941期)

1.0.3079-預發布版本

發行日期：2025年1月24日

NuGet 套件用於 WebView2 SDK 1.0.3079-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 版本 134.0.3079.0 或更高版本附帶的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

自訂搜尋行為 (尋找 API)

Find API 允許你以程式方式控制 Find 操作，並能為您的應用程式新增以下功能：

  • 自訂搜尋選項，包括尋找詞彙、大小寫敏感度、Word 匹配、匹配高亮及預設 UI 抑制。
  • 找到文字字串，並在 WebView2 控制項中切換。
  • 程式化啟動 搜尋 操作，並瀏覽 搜尋 結果。
  • 抑制預設 的搜尋 介面。
  • 追蹤 尋找 行動的狀態。

PDF 文件的 Find API 已知存在問題。 當你在 WebView2 控制項中查看 PDF 文件時， 搜尋 功能目前只會顯示第一個索引和找到的匹配數量。 例如，如果該字串在 PDF 中出現三次，介面會顯示 1/3 ，且無法程式化呼叫 Next 或 Previous 。 我們正積極調查這些問題，並鼓勵您透過 WebView2Feedback 倉庫回報遇到的任何問題。

自訂拖放行為 (DragStarting API)

DragStarting API 在視覺主機模式下會覆寫預設的拖放行為。 當使用者在 WebView2 中開始拖曳操作時，事件 DragStarting 會通知你的應用程式，並提供用你自己的邏輯覆蓋預設 WebView2 拖曳操作所需的狀態。

  • 在 DragStarting 上 ICoreWebView2ExperimentalCompositionController6 加入一個事件處理器，當拖曳操作開始時會被呼叫。
  • 用 ICoreWebView2ExperimentalDragStartingEventArgs 來開始你自己的拖車作業。
    • 使用此 GetDeferral 方法執行任何非同步拖曳邏輯，並在稍後再呼叫回 WebView。
    • 利用這個 Handled 屬性讓 WebView2 知道是否要使用自己的拖曳邏輯。
追蹤巢狀 iframes 的導航歷史 (FrameCreatedEvent API)

FrameCreatedEvent API 支援巢狀 iframe，例如記錄二級 iframe 的導航歷史。 若無此 API，WebView2 僅追蹤第一層級 iframe，即主框架的直接子 iframe。 透過這個 API，你的應用程式可以訂閱巢狀 iframe 建立事件，讓應用程式能存取巢狀 iframe 的所有 CoreWebView2Frame 屬性、方法和事件。

使用此 API 管理包含多層 iframe 的頁面上的 iframe 追蹤。 您可以選擇追蹤以下任一項：

  • 只有主頁和第一層的 iframe (預設行為) 。
  • 一個部分 WebView2 框架樹，包含特定的感興趣 iframe。
  • 完整的 WebView2 框架樹。
在 WebView2 初始化時設定預設背景色 (DefaultBackgroundColor API)

DefaultBackgroundColor API 允許使用者在初始化時設定該 DefaultBackgroundColor 屬性。 這可避免在 WebView2 載入過程中出現干擾性的白光閃爍。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 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 控制項總是顯示在最上方，導致任何 WPF 元素都被隱藏在同一位置，即使你嘗試用視覺樹狀順序或 z-index 屬性，將 WPF 元素設定在 WebView2 控制項之上， (例如) 。

此問題發生是因為 WPF 控制使用該 WPF HwndHost 來承載 Win32 WebView2 控制項，且 HwndHost 存在空域問題。

另請參閱:

Bug 修正

僅執行時
  • 修正了顯示變更導致 WebView2 渲染比應用程式視窗還小的迴歸問題。
  • 啟用 IsolateSandboxedIframes 了 WebView2 的上游功能。
  • 防止在版本變更時刪除服務人員。
  • 現在的 CleanUpSome API Hostobject 只對整個堆積進行垃圾回收。 CleanUpSome 已從V8引擎中移除。
  • 修正了 的 AreBrowserAcceleratorKeysEnabled迴歸。 (第#5033期)
  • 修正了一個用鍵盤關閉對話時沒觸發的錯誤 IsDefaultDownloadDialogOpenChanged 。 (第#4807號)
僅限 SDK
  • 修正了 WPF WebView2CompositionControl 中一個問題，當初始化時大小為 0,0 () ，例如初始化為 TabItem a 或 TabControl。 (第4941期)

1.0.2903.40

上映日期：2024年11月18日

NuGet 套件 for WebView2 SDK 1.0.2903.40

為了完整 API 相容性，本版本的 WebView2 SDK 需要 WebView2 執行時版本 131.0.2903.40 或更高版本。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

控制螢幕擷取 UI 是否會顯示 (ScreenCaptureStarting 事件)

新增了一個活動 ScreenCaptureStarting 。 每當對應該 CoreWebView2Frame (或其後繼 iframe) 在顯示介面前請求使用螢幕擷取 API 權限時，就會觸發此事件。 應用程式可以阻擋 UI 顯示，或允許顯示該 UI。

Bug 修正

僅執行時
  • 讓 下載 對話框在啟動時獲得初始焦點。

一般變動

  • Microsoft Edge WebView2 執行時不再列在 Windows 設定>中的應用程式>已安裝應用程式中，因為它是持續存在的系統元件。

1.0.2950-預釋版本

上映日期：2024年11月18日

NuGet 套件用於 WebView2 SDK 1.0.2950-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 132.0.2950.0 或更高版本所附的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

本預發布 SDK 中未新增任何實驗性 API。

預發行 (階段穩定版的推廣)

在此預發布 SDK 中，尚未將任何 API 從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段。

Bug 修正

僅執行時
  • 讓 下載 對話框在啟動時獲得初始焦點。
  • 在取消前往特定網站 FrameNavigationStarting的導航時，修正了當機問題。 (第4843期)
  • 當觸控選擇選單顯示時，自訂右鍵選單的行程被延後了。 (第4737號)
僅限 SDK
  • 新增 Arm64ec 支援。
  • 修正了 WebView2 在「視窗到視覺化」模式下無法接收加速器輸入的問題。

1.0.2849.39

上映日期：2024年10月21日

NuGet 套件 for WebView2 SDK 1.0.2849.39

為了完整 API 相容性，本版本的 WebView2 SDK 需要 WebView2 執行時版本 130.0.2849.39 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

在儲存檔案時設定安全警告 (SaveFileSecurityCheckStarting 事件)

新增了一個活動 SaveFileSecurityCheckStarting 。 你的應用程式可以在此事件註冊一個處理器，取得檔案路徑、檔名副檔名及文件來源 URI 資訊。 接著你可以套用自己的規則來執行以下動作：

  • 允許儲存檔案時不會顯示預設的安全警告介面。
  • 取消存錢。
  • 建立自己的 UI 來管理執行時的檔案類型政策。

Bug 修正

僅執行時
  • 修正了按 Tab 或 Shift+Tab 切換到 Webview2 控制時，下載 對話框焦點問題。
僅限 SDK
  • 現在不再使用無CoreWebView2WebResourceRequestSourceKinds參數的使用CoreWebView2.AddWebResourceRequestedFilter。 請參考 .NET CoreWebView2.AddWebResourceRequestedFilter 方法。
  • 新增 .NET 8 TargetFramework for C# WinRT，啟用 AOT (提前) 相容性，並關閉執行時編組。

1.0.2895-預發布

上映日期：2024年10月21日

NuGet 套件用於 WebView2 SDK 1.0.2895-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 131.0.2895.0 或更高版本的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

RestartRequested 當 WebView2 需要重新啟動時發生事件

新增了一個活動 RestartRequested 。 每當 WebView2 需要重啟以套用更新或設定變更時，該 RestartRequested 事件就會被觸發。 你可以利用這個 API 偵測 WebView2 何時需要重新啟動，並採取適當的操作。 Priority事件參數的RestartRequested屬性表示重新啟動請求的優先順序：

  • High 表示應用程式應盡快提醒使用者重新啟動。
  • Normal 表示應用程式應以盡力而為的方式提醒使用者重新啟動。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

控制螢幕擷取介面是否會顯示 (ScreenCaptureStarting 事件)

新增了一個活動 ScreenCaptureStarting 。 每當對應該 CoreWebView2Frame (或其後繼 iframe) 在顯示介面前請求使用螢幕擷取 API 權限時，就會觸發此事件。 應用程式可以阻擋 UI 顯示，或允許顯示該 UI。

在儲存檔案時設定安全警告 (SaveFileSecurityCheckStarting 事件)

新增了一個活動 SaveFileSecurityCheckStarting 。 你的應用程式可以在此事件註冊一個處理器，取得檔案路徑、檔名副檔名及文件來源 URI 資訊。 接著你可以套用自己的規則來執行以下動作：

  • 允許儲存檔案時不會顯示預設的安全警告介面。
  • 取消存錢。
  • 建立自己的 UI 來管理執行時的檔案類型政策。

Bug 修正

僅限 SDK
  • 已修正 Arm64 與 WindowsAppSDK 1.6 不相容的問題。
  • 在 WinAppSDK 機殼裡移除了多餘 WebView2Loader.dll 的部分。
  • 現在不再使用無CoreWebView2WebResourceRequestSourceKinds參數的使用CoreWebView2.AddWebResourceRequestedFilter。 請參考 .NET CoreWebView2.AddWebResourceRequestedFilter 方法。

1.0.2792.45

上映日期：2024年9月23日

NuGet package for WebView2 SDK 1.0.2792.45

為完全 API 相容性，此版本的 WebView2 SDK 需 WebView2 執行時版本 129.0.2792.45 或更高版本。

第三階段 (穩定版)

在本版本 SDK 中，尚未將 API 從預發布階段的第二階段穩定升級為第三階段：穩定發布階段。

Bug 修正

僅限 SDK
  • 修正了 .NET 專案對 SDK 的依賴。 (第4743期)

1.0.2839-預發布

上映日期：2024年9月23日

NuGet 套件 for WebView2 SDK 1.0.2839-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 版本 130.0.2839.0 或更高版本附帶的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

本預發布 SDK 中未新增任何實驗性 API。

預發行 (階段穩定版的推廣)

在此預發布 SDK 中，尚未將任何 API 從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段。

Bug 修正

僅執行時
  • 修正了一個問題：在 WinAppSDK 中，關閉 Windows 的「捲動非啟用視窗」設定，專注於 WebView2 控制項會導致捲動失敗。
  • 在 WebView2 中被 edge://wallet 封鎖。 (第#4710號)
  • 控制器建立完成後，我清除了 .NET WebView2 控制項中預設背景色的環境變數。
  • 啟用 Webview2 在視覺主機模式下的無障礙支援。
  • 修正了一個錯誤，就是移除多個來源的「網路資源請求」篩選器，當其中一個是文件時。
  • 修正了 WinUI 或其他視覺化託管的 WebView2 實例中看不到的迴歸 DataList 現象。
僅限 SDK
  • 修正了 .NET 專案對 SDK 的依賴。 (第4743期)
  • 在與 GetAvailableBrowserVersionString() 較舊 WebView2Loader.dll的 T. (第4395號)
  • 修正了在編譯 wv2winrt 生成程式碼時，搭配 cpp20 和 /permissive- 選項的問題。
  • 新增 .NET 8 TargetFramework for C# WinRT，啟用 AOT (提前) 相容性，並關閉執行時編組。

1.0.2739.15

上映日期：2024年8月26日

NuGet package for WebView2 SDK 1.0.2739.15

為了完整 API 相容性，此版本的 WebView2 SDK 需要 WebView2 執行時版本 128.0.2739.15 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

網頁通知處理

新增對網頁通知的支援，適用於非持久性通知。 NotificationReceived該CoreWebView2事件控制網頁通知處理，允許主機應用程式進行自訂或抑制。 未處理的通知預設使用 WebView2 的介面。

另存為

新增 SaveAs 了允許你程式化執行 另存為 操作的 API。 你可以用這些 API 封鎖預設的 另存 為對話框，然後靜默儲存，或自己建立另 存為 UI。 這些 API 僅適用於 另存為 對話框，不適用於 下載對話框 ，後者仍使用現有的下載 API。

Bug 修正

此版本 SDK 中沒有任何錯誤修正。

1.0.2783-預發布

上映日期：2024年8月26日

NuGet 套件用於 WebView2 SDK 1.0.2783-prerelease

為完整 API 相容性，此 WebView2 SDK 預發布版本需使用 Microsoft Edge 版本 129.0.2783.0 或更高版本的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

本預發布 SDK 中未新增任何實驗性 API。

預發行 (階段穩定版的推廣)

在此預發布 SDK 中，尚未將任何 API 從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段。

Bug 修正

執行環境與 SDK
  • 重新啟用預設行為 SetUserAgent：預設情況下， SetUserAgent 對於跨原點的 iframes 有效。
僅執行時

  • 預設啟用了互動拖曳功能。 請參閱 edge-webview-interactive-draggingWebView2 瀏覽器的旗標。

  • WebView2 已停用 IsolateSandboxedIframes 。

  • 修正了 WebView 建立在多個實例同時啟動時失敗的問題。 (第4731期)

  • 修正了 WinRT JavaScript 投影中的一個錯誤，該錯誤導致物件名稱包含 Proxy 或 Function 因名稱碰撞而產生錯誤的物件中，現有屬性會快取。

  • 修正了一個 Bug，就是 WebView2 控制鍵在斷開再重新連接螢幕後大小變錯了。

  • 修正了「mailto：」連結會留下一個沒有標題的彈出視窗，而不是自動關閉彈出視窗的問題。

僅限 SDK

  • C# WinRT 投影現在在 UWP 上可用。

  • 修正了一個問題，確保 C# WinRT 投影的 Visual Studio 中不再顯示。GeneratedFilesDir

1.0.2651.64

上映日期：2024年8月13日

NuGet package for WebView2 SDK 1.0.2651.64

為了完全 API 相容性，本版本的 WebView2 SDK 需要 WebView2 執行時版本 127.0.2651.64 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 更新了 WebMessageObjects API，允許將 DOM 物件注入 WebView2 中，這些內容是透過應用程式建構的，反過來則透過 CoreWebView2.PostWebMessage API 注入。 新增一個網頁物件類型 (CoreWebView2FileSystemHandle) ，代表可貼入網頁內容並提供檔案系統存取權限的檔案系統句柄。

Bug 修正

僅執行時
  • 修正了某些網站事件崩潰的回歸 WebResourceRequested 問題。 (第4602期)
僅限 SDK
  • 修正了 WinRT C# 投影的 x86。

1.0.2730-預釋版本

發行日期：2024年8月7日

NuGet 套件 for WebView2 SDK 1.0.2730-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 128.0.2730.0 或更高版本所附的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增了限速控制 API，允許你透過限速 JavaScript 計時器來有效管理資源。 這在需要保持 WebView2 控制項可見，但需要減少資源消耗 (（例如使用者未與內容) 互動時）的情境中很有幫助。 這些限速控制 API 允許您：
    • 可自訂腳本計時器， (setTimeout 與 setInterval) 在不同頁面狀態下， (前景、背景和背景，並有密集的節流) 。
    • 在特定託管的 iframe 中設定腳本計時器。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 新增 SaveAs 了允許你程式化執行 另存為 操作的 API。 你可以用這些 API 封鎖預設的 另存 為對話框，然後靜默儲存，或自己建立另 存為 UI。 這些 API 僅適用於 另存為 對話框，不適用於 下載對話框 ，後者仍使用現有的下載 API。
  • 新增對網頁通知的支援，適用於非持久性通知。 NotificationReceived該CoreWebView2事件控制網頁通知處理，允許主機應用程式進行自訂或抑制。 未處理的通知預設使用 WebView2 的介面。

Bug 修正

僅執行時

  • 修正了無法透過系統指令控制應用程式視窗的問題， (如 Alt+F4 或 Alt+Spacebar) ，當焦點置於 WebView2 進行視覺託管模式時。 (第#2961期)

  • 修正了 WebView2 UWP 中無法從主機應用程式點擊搜尋欄的錯誤。

僅限 SDK

  • 新增缺少的 WinRT CoreWebView2Notification.VibrationPattern API。 此 WinRT API 可與穩定通知 API 推廣版本說明結合;請參見「Web Notification」以及 NotificationReceived WinRT，請見上方。

  • 修正了 KeyDown WinForms WebView2 控制項事件中沒有包含正確 ModifierKeys 資訊的問題。 (第#1216號)

  • 修正了 WinRT C# 投影的 x86。

  • 在執行時更新期間，針對潛在的競賽條件，做CreateCoreWebView2EnvironmentGetAvailableCoreWebView2BrowserVersionString得更穩健。

1.0.2592.51

上映日期：2024年6月19日

NuGet package for WebView2 SDK 1.0.2592.51

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 126.0.2592.51 或更高版本。

第三階段 (穩定版)

在本版本 SDK 中，尚未將 API 從預發布階段的第二階段穩定升級為第三階段：穩定發布階段。

Bug 修正

僅執行時

  • WebView2 TextureStream已停用BreakoutBoxPreferCaptureTimestampInVideoFrame。

  • 修正了一個迴歸問題，事件 WindowCloseRequested 只會在第一次 window.close() 呼叫時觸發。

  • 修正了一個迴歸問題，導致 WinRT JavaScript 投影中的型別陣列無法像 IDispatch 主機一樣處理。

  • 修正了一個自動填充彈出視窗會立即關閉並導致焦點切換的錯誤。

  • 修正了一個 WebView2 因 . 而無法載入的 AppPolicyGetWindowingModel錯誤。 (第4591期)

1.0.2646-預發布

上映日期：2024年6月19日

NuGet 套件用於 WebView2 SDK 1.0.2646-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 版本 128.0.2646.0 或更高版本附帶的 WebView2 執行環境。

一般功能

  • 新增對 C#/WinRT .NET 6+ 的支援。

實驗特徵

  • 引入了特徵標誌 msWebView2EnableDownloadContentInWebResourceResponseReceived，這是一個實驗性特徵 (，而非穩定特徵) 。 啟用此旗標後，能在 中提供 WebResourceResponseReceived成為下載的導航回應。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增了一個活動 SaveFileSecurityCheckStarting 。 作為開發者，你可以在此事件註冊一個處理器，取得檔案路徑、檔名副檔名及文件來源 URI 資訊。 接著你可以套用自己的規則來執行以下動作：
    • 允許儲存檔案時不會顯示預設的安全警告介面。
    • 取消存錢。
    • 建立自己的 UI 來管理執行時的檔案類型政策。
  • 新增了一個活動 ScreenCaptureStarting 。 每當對應該 CoreWebView2Frame (或其後繼 iframe) 在顯示介面前請求使用螢幕擷取 API 權限時，就會觸發此事件。 作為開發者，你可以選擇封鎖 UI 顯示，或允許 UI 顯示。
  • 在 .NET 類別新增了一個 GetComICoreWebView2CoreWebView2 方法，讓你能在 .NET 和 COM 之間轉換 a CoreWebView2 。 新增了一個 WinRT 介面，讓你可以在 WinRT 和 COM 之間轉換 a CoreWebView2 。 這讓你能在不同語言撰寫的函式庫之間互通。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 更新了 WebMessageObjects API，允許將 DOM 物件注入 WebView2 中，這些內容是透過應用程式建構的，反過來則透過 CoreWebView2.PostWebMessage API 注入。 新增一種網頁物件類型，代表可貼入網頁內容並提供檔案系統存取權限的檔案系統帳號。

Bug 修正

僅執行時
  • 修正了視覺化主機自有視窗啟動邏輯的錯誤。

1.0.2535.41

上映日期：2024年5月28日

NuGet 套件 for WebView2 SDK 1.0.2535.41

為了完整 API 相容性，本版本 WebView2 SDK 需要 WebView2 執行時版本 125.0.2535.41 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 支援流暢風格覆蓋捲軸。

Bug 修正

僅執行時

  • 修正了一個錯誤，如果 LaunchingExternalURIScheme 事件處理程式被附加且啟用 了「永遠記住 」勾選框，使用者選擇了這個勾選框，對話框就會再次錯誤顯示。

  • 修正了視覺主機的文字編輯控制在失去焦點後會重複 IME 輸入的問題。

  • 修正了完全信任 UWP 應用程式無法顯示自有視窗的問題。

僅限 SDK
  • 修正了 SDK 中導致 .NET 專案平台列表中 Platform> 值錯誤<的問題。 (第#1755期)

1.0.2584-預發布版本

上映日期：2024年5月28日

NuGet 套件用於 WebView2 SDK 1.0.2584-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要安裝隨 Microsoft Edge 版本 126.0.2584.0 或更高版本附帶的 WebView2 執行環境。

實驗特徵

  • 引入取消初始導覽的選項，以提升啟動效能。 此變更預設為停用，並可透過功能 msWebView2CancelInitialNavigation 旗標啟用。

預發布 (中晉升為第一階段實驗)

本預發布 SDK 中未新增任何實驗性 API。

預發行 (階段穩定版的推廣)

在此預發布 SDK 中，尚未將任何 API 從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段。

Bug 修正

執行環境與 SDK
  • 修正了當 .NET host 物件非同步方法回傳 null 結果時的當機。 (第#4509號)
僅執行時

  • 修正了視窗關閉時 WebView2 記憶體洩漏的問題。 (第4286號)

  • 修正了一個 ignoreMemberNotFoundError .NET 物件無法運作的問題。 (第4497期)

  • 現在當呼叫時，會回傳一個正確的錯誤碼 CreateSharedBuffer ，緩衝區大小為 0。 (第4554號)

  • 已修正滑槽瀏覽對話框的啟用問題。

  • 修正了 WebView2 Visual Hosting CursorChanged 事件無法觸發自訂游標的問題。

1.0.2478.35

上映日期：2024年4月22日

NuGet 套件 for WebView2 SDK 1.0.2478.35

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 124.0.2478.35 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 新增執行時選擇功能，以支援更多預發布測試與飛行情境。 你可以指定 ReleaseChannels 在建立環境時選擇要搜尋的頻道，以及 ChannelSearchKind 選擇搜尋順序。

Bug 修正

僅執行時
  • 修正了在 WebMessage API 中使用 AdditionalObjects 時可能導致當機的整數溢位問題。

1.0.2526-預發布

上映日期：2024年4月22日

NuGet 套件for WebView2 SDK 1.0.2526-prerelease

為完整 API 相容性，此 WebView2 SDK 預發布版本需使用 Microsoft Edge 版本 125.0.2526.0 或更高版本的 WebView2 執行環境。

重大變更

最低 .NET Framework 版本

.NET WebView2 的最低 .NET Framework 版本要求，包括 WPF 與 WinForms 控制項，已從 .NET Framework 4.5 更新至 .NET Framework 4.6.2。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增 SaveAs 了允許你程式化執行 另存為 操作的 API。 你可以用這些 API 封鎖預設的 另存 為對話框，然後靜默儲存，或自己建立另 存為 UI。 這些 API 僅適用於 另存為 對話框，不適用於 下載對話框 ，後者仍使用現有的下載 API。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 支援流暢風格覆蓋捲軸。

Bug 修正

執行環境與 SDK

  • 修正了 WinRT JavaScript 投影中的一個錯誤，該錯誤中傳遞已型別陣列時會出現「介面不支援」錯誤。 (第#3486期)

  • 新增支援處理 out WinRT JavaScript 投影中的陣列參數。

僅執行時

  • 修正了一個預設啟用圖片自動字幕功能的錯誤。

  • 修正了一個錯誤，如果 LaunchingExternalURIScheme 事件處理程序已附加，且啟用 了「永遠記住 」勾選框，使用者選擇此勾選框，對話框會再次錯誤顯示。

  • 修正 GetNonClientRegionAtPoint 了部分點數錯誤回 Nowhere 傳的問題。

  • 修正了一個 Text Services Framework 在將檔案丟入 WebView2 區域時會斷線的錯誤。

  • 修正了一個錯誤，當設定AreDevToolsEnabled為 .false

  • 修正了一個 bug，就是在重新獲得焦點時，可組合的 IME 會被複製。 (第#1610號)

  • 確保它 devicePixelRatio 與自訂光柵化比例同步。 (第#3060號)

  • 在使用 CallDevToolsProtocolMethod 事件時 NewWindowRequested修正了競賽條件。 (第4181期)

  • 修正了 WPF TabIntoCore 中當 Tab Controller 被摧毀後，使用者嘗試按 Tab 鍵 (Tab 鍵進入控制鍵時會發生的當機) 。 (第4452期)

  • 確保拼字檢查能接受輸入語言，格式大小寫不區分。

  • 讓語言 API 在使用者輸入方面更穩健。

  • 修正了一個存 檔密碼 的錯誤？提示未顯示。

僅限 SDK
  • 修正了 WinRT 投影中缺少 AreBrowserExtensionsEnabled 的 API。

1.0.2420.47

上映日期：2024年3月25日

NuGet 套件 for WebView2 SDK 1.0.2420.47

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 123.0.2420.47 或以上。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 新增了一個 API，可以針對 WebView2 所包含的區域提供測試結果。 此 API 對於視覺化託管的應用程式非常有用，這些應用程式希望處理 WebView2 視窗非用戶端區域的滑鼠事件。
  • 在型別中加入FailureSourceModulePath了該屬性ProcessFailedEventArgs，以指定在 Windows 程式碼完整性失敗時，導致當機的模組完整路徑——也就是程序以 。STATUS_INVALID_IMAGE_HASH

Bug 修正

僅限 SDK
  • WinForms 和 WPF 的 .NET 組合現在已經啟用了優化功能。 (第4409期)

1.0.2470-預釋版

上映日期：2024年3月25日

NuGet 套件 for WebView2 SDK 1.0.2470-prerelease

為完整 API 相容性，此 WebView2 SDK 預發布版本需 WebView2 執行時版本 124.0.2470.0 或更高。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 支援流暢風格覆蓋捲軸。
  • 更新了 WebMessageObjects API，允許將 DOM 物件注入 WebView2 內容中，這些內容是透過應用程式建構的，且 CoreWebView2.PostWebMessage 透過 API 反向注入。 新增一種網頁物件類型，代表可貼入網頁內容並提供檔案系統存取權限的檔案系統帳號。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 新增執行時選擇功能，以支援更多預發布測試與飛行情境。 你可以指定 ReleaseChannels 在建立環境時選擇要搜尋的頻道，以及 ChannelSearchKind 選擇搜尋順序。
  • 在型別中加入FailureSourceModulePath了該屬性ProcessFailedEventArgs，以指定在 Windows 程式碼完整性失敗時，導致當機的模組完整路徑——也就是程序以 。STATUS_INVALID_IMAGE_HASH

Bug 修正

僅執行時

  • 修正了當舊版 WebView2 用戶端 DLL 卸載時，可能導致應用程式程序當機的可靠性回歸問題。

  • 確保 WebView2 的臨時下載資料夾在每個使用者資料資料夾中都是唯一的，且不會干擾其他應用程式或瀏覽器。

1.0.2365.46

上映日期：2024年2月26日

NuGet package for WebView2 SDK 1.0.2365.46

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 122.0.2365.46 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 新增對 for workers 的支援 WebResourceRequested ，允許設定過濾器以接收 WebResourceRequested 服務人員、共享員工及不同來源 iframe 的事件。
  • 為了支援 WebView2 中新增 GetBrowserExtensions 的瀏覽器擴充功能，適用於 WinRT：

不適用

Bug 修正

僅執行時

  • 修正了一個迴歸問題，影響了當新視窗設定為來源 WebView 時事件 NewWindowRequested 的處理。 (第4250號)

  • 修正了一個錯誤，關閉帶有嵌入 PDF 檢視器的 WebView 可能會導致當機。 (第#3832號)

  • 修正了應用程式啟用 SetWindowDisplayAffinity時滑鼠點擊停止運作的倒退問題。 (第4325期)

1.0.2415-預發布

上映日期：2024年2月26日

NuGet 套件用於 WebView2 SDK 1.0.2415-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 123.0.2415.0 或更高版本的 WebView2 執行時。

重大變更

  • 屬性CoreWebView2LaunchingExternalUriSchemeEventArgs的行為InitiatingOrigin已經改變。 如果 是InitiatingOrigin不透明的起源，事件InitiatingOrigin中報告的 args 就是它的前驅起源。 前驅起源是創造不透明起源的起源。 例如，若一個位於 的 example.com 參考系開啟了一個具有不同不透明原點的子框架，則該子框架的前驅原點為 example.com。
  • CoreWebView2TextureStreamErrorKind enum成員已更名：

舊成員名稱：

新成員名稱：

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 該 CoreWebView2ControllerOptions 類別現在有一個 AllowHostInputProcessing 屬性，允許使用者輸入的訊息 (鍵盤、滑鼠、觸控和筆的) ，透過瀏覽器視窗傳遞，並由應用程式的程序視窗接收。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 新增了一個 API，可以針對 WebView2 所包含的區域提供測試結果。 此 API 對於視覺化託管的應用程式非常有用，這些應用程式希望處理 WebView2 視窗非用戶端區域的滑鼠事件。

Bug 修正

僅執行時

  • 修正了當權限請求設為「未持續」 (也就是) 時，無法在 Google Meet 或 Teams 會議中開啟攝影機或麥克風的問題Microsoft SavesInProfile = false 。 (第#3592號)

  • 修正了在 WebView2 瀏覽器程序中附加一個空 --edge-webview-custom-scheme 的命令列交換器。

  • 停用了全域 UserDataFolder 登錄檔金鑰，讓這個登錄檔金鑰只能套用到每個應用程式。

  • 修正 NewWindowRequested 了瀏覽器擴充功能開啟時事件未觸發的問題。 (第#3841期)

  • 修正 NewWindowRequested 了開啟檢視來源時事件未觸發的問題。 (第4162期)

  • 修正了下載時觸發StateChangedBytesReceivedChanged和觸發事件的問題。

  • 修正了一個對話導致 WebView2 視窗意外跳動位置的錯誤 BeforeUnload 。 (第4350號)

  • 修正了如果太早被呼叫，且 PDF 尚未完全載入，列印空白頁的問題 PrintAsync 。 (第3779期)

1.0.2277.86

發行日期：2024年2月5日

NuGet 套件 for WebView2 SDK 1.0.2277.86

為完全 API 相容性，此版本 WebView2 SDK 需 WebView2 執行時版本 121.0.2277.86 或更高版本。

重大變更

活動 about:blank 中導航功能現在可 NavigationStarting 取消。 要恢復舊行為，請停用 msWebView2CancellableAboutNavigations 功能標記。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • ExecuteScriptWithResult 若腳本失敗，提供例外資訊。 TryGetResultAsString 取得腳本執行結果的字串而非 JSON，以便更方便地與字串結果互動：

Bug 修正

僅執行時

  • 確保拼字檢查語言在程式上相符 put_Language 。 自訂的上下文選單也會更新，並進行正確的拼字檢查。 (僅執行時)

  • 修正了一個錯誤，導致某些載入 AV1 編碼影片的網站事件不再出現 NavigationCompleted 。 (僅執行時) (第#3801號)

  • 修正了主機程序 COM 資源在 WebView 拆除時會被釋放的問題。 (僅執行時) (第#4226號)

  • 修正了一個載入部分社群媒體應用程式（如 Facebook、Twitter 和 LinkedIn）時的錯誤。 此變更是針對執行時的特性。 (僅執行時) (第4281期)

1.0.2357-預釋版本

上映日期：2024年1月30日

NuGet 套件用於 WebView2 SDK 1.0.2357-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 122.0.2357.0 或更高版本的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增執行時選擇功能，以支援更多預發布測試與飛行情境。 開發者可在環境建立時指定 ReleaseChannels 選擇搜尋哪些頻道，並 ChannelSearchKind 選擇搜尋順序。
  • 新增了一個 API，可以針對 WebView2 所包含的區域提供測試結果。 此 API 對於視覺化託管的應用程式非常有用，這些應用程式希望處理 WebView2 視窗非用戶端區域的滑鼠事件。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • CoreWebView2AcceleratorKeyPressedEventArgs 新增了一個 IsBrowserAcceleratorKeyEnabled 特性，讓你可以控制瀏覽器是否會處理加速鍵 (捷徑鍵) ，例如 Ctrl+P 或 F3：
  • Frame Process Info API（包括 GetProcessExtendedInfos）提供所有在相關渲染程序中正在執行的框架快照集合。 此 API 使主機應用程式能偵測 WebView2 中哪個部分正在消耗資源，例如記憶體或 CPU 使用率：
  • ExecuteScriptWithResult 若腳本失敗，提供例外資訊。 TryGetResultAsString 取得腳本執行結果的字串而非 JSON，以便更方便地與字串結果互動：
  • CreateFromComICoreWebView2 會將現有 ICoreWebView2 物件包裝在實例中 CoreWebView2 ，讓 .NET 開發者能與 C++ 建立的控制項互動。
  • 為了支援 WebView2 中新增 GetBrowserExtensions 的瀏覽器擴充功能，適用於 WinRT：

不適用

  • 新增對 for workers 的支援 WebResourceRequested ，允許設定過濾器以接收 WebResourceRequested 服務型員工、共享員工及不同起源 iframe 的事件。

Bug 修正

僅執行時

  • 修正了一個錯誤，關閉包含 PDF 檢視器的 WebView 控制項可能導致當機。 (僅執行時) (第3832期)

  • 已修正子程序工作列圖示堆疊的問題。 (僅執行時) (#3245)

  • 修正了一個錯誤，導致發送了不必要的網路請求給 Edge Cloud Config Service。 (僅執行時) (第4180號)

  • 更新了 CSS 屬性的行為 app-region ，使其值變更會觸發頁面重新排版。 (僅執行時)

  • 修正 put_AreBrowserAcceleratorKeysEnabled 了一個無法更新 WebView2 設定且沒有 AcceleratorKeyPressed 註冊事件處理程序的問題。 (僅執行時) (#4278)

僅限 SDK

  • 修正了 .NET 中 WebView2 控制項無法在 UNC 路徑上找到的問題 WebView2Loader.dll 。 (僅支援 SDK) (第 #4081)

  • 修正了一些導致 .NET 控制項實 InvalidOperationException 例的問題，這些問題對開發者沒什麼幫助。 (僅支援 SDK) (#4272)

1.0.2210.55

上映日期：2023年12月11日

NuGet 套件 for WebView2 SDK 1.0.2210.55

為完全 API 相容性，此版本 WebView2 SDK 需 WebView2 執行時版本 120.0.2210.55 或更高。

重大變更

未封裝的 Windows 32 應用程式，使用 Windows 10 上修正版 120+

如果你正在開發一個未封裝的 Win32 應用程式，使用 Fixed Version Runtime v120 或更高版本，並針對Windows 10裝置，你需要在) (icacls 執行幾個 ACL shell 指令，以避免當機，因為 WebView2 新增了一項安全功能。 參見[Breaking Change] 未封裝的 Win32 應用程式，使用 Windows 10 上的修正版 v120+，需要 ACL。

修復方法見於文章《Distribute your app and the WebView2 Runtime》中「固定版執行分發模式」章節，步驟「在 Windows 10 裝置上，從 Fixed 版本 120 開始，使用固定版開發未封裝 Win32 應用程式的使用者必須執行以下指令。」

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • WebView2 對瀏覽器擴充功能的支援：
  • Frame Process Info API（包括 GetProcessExtendedInfos）提供所有在相關渲染程序中正在執行的框架快照集合。 此 API 使主機應用程式能偵測 WebView2 中哪個部分正在消耗資源，例如記憶體或 CPU 使用率：
  • ICoreWebView2AcceleratorKeyPressedEventArgs 新增 IsBrowserAcceleratorKeyEnabled 一項特性，讓開發者能控制瀏覽器是否處理加速鍵 (捷徑鍵) ，例如 Ctrl+P 或 F3：
  • 新增管理檔案刪除的支援：

Bug 修正

1.0.2151.40

上映日期：2023年11月6日

NuGet 套件 for WebView2 SDK 1.0.2151.40

為了完整 API 相容性，本版本的 WebView2 SDK 需要 WebView2 執行時版本 119.0.2151.40 或更高。

正式發行

重要事項

公告：Xbox WebView2 SDK 現已 (通用) 正式開放，並可於 Xbox 10 月 2310 版本 (231018-2200) 上取得。 更多細節請參閱 WebView2 的 Xbox 公告。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 在事件參數中新增來源框架資訊 NewWindowRequested ，以識別請求來源：
  • 對於 WinRT，新增了管理自訂方案註冊的選項，以建立：CoreWebView2Environment

Bug 修正

  • 修正了多次建立 WebView 可能導致當機的可靠性問題。 (僅執行時) (第3793號)

1.0.2194-預釋版本

上映日期：2023年11月6日

NuGet 套件用於 WebView2 SDK 1.0.2194-prerelease（prerelease）

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 版本 120.0.2194.0 或更高版本附帶的 WebView2 執行時。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • WebView2 對瀏覽器擴充功能的支援：

Bug 修正

  • 修正了 WebView2 有時在切換螢幕縮放或切換 RDP 與擴充底座模式後，呈現模糊或無內容的問題。 (僅執行時)

  • 修正 TextServicesFoundation 了當 WebView2 實例被摧毀時導致當機的問題。 (僅執行時)

  • 修復 .NET 中當網頁訊息從 WebView2 傳送，但應用程式端未讀取時的記憶體洩漏。 (執行時與 SDK) (第#3794)

  • 已修正一個導致 ScaleFactor 所有 WebView2 列印 API 設定無法正常運作的問題。 (僅執行時) (第4082)

1.0.2088.41

上映日期：2023年10月16日

NuGet package for WebView2 SDK 1.0.2088.41

為完整 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 118.0.2088.41 或以上。

第三階段 (穩定版)

在本版本 SDK 中，尚未將 API 從預發布階段的第二階段穩定升級為第三階段：穩定發布階段。

Bug 修正

  • 修正了導致部分 UWP 應用程式無法輸入文字的問題。 (僅執行時) (第#3805期)

  • 修正了使用 Windows PerProcessSystemDPIForceOff 相容性設定的應用程式初始化失敗。 (僅執行時) (第#3692號)

  • 已修正 WebView2 中對話位置偏移的錯誤。 (僅執行時) (第#3763期)

1.0.2164-預釋版本

上映日期：2023年10月18日

NuGet 套件 for WebView2 SDK 1.0.2164-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 版本 120.0.2164.0 或更高版本附帶的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 在型別中加入FailureSourceModulePath了該屬性ProcessFailedEventArgs，以指定在 Windows 程式碼完整性失敗時，導致當機的模組完整路徑——也就是程序以 。STATUS_INVALID_IMAGE_HASH

Bug 修正

  • 新增對 PrintToPDF API 中頁面設定 (PageRange 與 PagesPerSheet) 的支援。 (僅執行時) (第#3719號)

  • 導覽擴充資源檔案時處理不正確，現在已以正確的處理方法修正。 (僅運行時) (第#3728期)

  • 修正了導致部分 UWP 應用程式無法輸入文字的問題。 (僅執行時) (第#3805期)

  • 修正了使用 Windows PerProcessSystemDPIForceOff 相容性設定的應用程式初始化失敗。 (僅執行時) (第#3692號)

  • 移除了在系統預設瀏覽器設定變更時收集資料的監視器。 (僅執行時)

  • 已修正 WebView2 中對話位置偏移的錯誤。 (僅執行時) (第#3763期)

  • 如果 設定NewWindow為 null，已修正事件當機NewWindowRequested的問題。 (僅執行時)

1.0.2045.28

上映日期：2023年9月18日

NuGet package for WebView2 SDK 1.0.2045.28

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 117.0.2045.28 或更高版本。

第三階段 (穩定版)

在本版本 SDK 中，尚未將 API 從預發布階段的第二階段穩定升級為第三階段：穩定發布階段。

Bug 修正

  • 預設關閉滑鼠手勢功能。 (僅執行時) (第3737期)

  • 修正了一個滑鼠滾輪捲動時不時壞掉的視覺化主機問題。 (僅執行時)

  • 修正了一個錯誤，就是在 WebView2 下載APK 檔案時，WebView2 瀏覽器程序會當機。 (僅執行時) (#3569)

1.0.2106-預釋版本

發行日期：2023年9月20日

NuGet 套件 for WebView2 SDK 1.0.2106-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 119.0.2106.0 或更高版本的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • Frame Process Info API（包括 GetProcessExtendedInfos）提供所有在相關渲染程序中正在執行的框架快照集合。 此 API 使主機應用程式能偵測 WebView2 中哪個部分正在消耗資源，例如記憶體或 CPU 使用率：

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 對於 WinRT，新增了管理自訂方案註冊的選項，以建立：CoreWebView2Environment
  • 在事件參數中新增來源框架資訊 NewWindowRequested ，以識別請求來源：

Bug 修正

運行時間

  • 更新了螢幕擷取介面，移除了分頁的提及。 (僅執行時)

  • 修正了一個 bug，就是 PrintAsync 印表機預設 DPI 無法列印。 (僅執行時) (第#3709期)

  • 當應用程式以不同管理員使用者身份執行時，修復 WebView 建立失敗。 (僅執行時) (第#3738期)

  • 修正了一個無法在 WinUI 3 上設定 WebView2 控制項自動化名稱的錯誤。 (僅執行時)

  • 啟用了使用非常舊 SDK 的應用程式的新進程間通訊實作。 (僅執行時)

SDK

  • 修正了一個 bug 是這個 CoreWebView2EnvironmentOptions.Language 屬性不會改變 HTTP 標頭的 accept-language 。 (僅支援 SDK) (第 #3635)

  • 新增了對較長執行時安裝路徑的支援。 (僅支援 SDK)

  • 自訂的 URI 方案註冊 API 現在可以在 WinRT 中運作。 關於 API 名稱與連結，請參閱上方 促銷區塊 中的「自訂方案註冊」條目。 (僅支援 SDK)

執行環境與 SDK
  • 修正了一個錯誤，當呼叫 SetPermissionState 時執行時會意外退出，使用無效的列舉值。 (執行時與 SDK)

1.0.1938.49

上映日期：2023年8月28日

NuGet 套件 for WebView2 SDK 1.0.1938.49

為了完整 API 相容性，本版本的 WebView2 SDK 需要 WebView2 執行時版本 116.0.1938.49 或更高版本。

第三階段 (穩定版)

在本版本 SDK 中，尚未將 API 從預發布階段的第二階段穩定升級為第三階段：穩定發布階段。

Bug 修正

  • 修正了一個 handle 追蹤的錯誤，導致 TextureStream API 使用可能失敗。 (僅執行時)

  • 修正了一個錯誤，就是在背景執行緒中建立的 WebView2 在建立時不會顯示到前景。 (僅執行時) (第#3584期)

  • 修正了 WebView2 內容有時在更改顯示設定 (（筆電睡眠）後呈現錯誤大小的錯誤;遠端;或連接或斷開外部顯示) 。 (僅限運行時間的) (第3429期)

  • 修正了一個在特定硬體配置上使用 WebView2 應用程式時會出現藍屏的錯誤。 (僅執行時) (第#3679期)

1.0.2065-預發布

上映日期：2023年8月30日

NuGet 套件 for WebView2 SDK 1.0.2065-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需使用 Microsoft Edge 版本 118.0.2065.0 或更高版本的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增來源框架資訊 NewWindowRequested以協助識別來源：

Bug 修正

  • 已停用 WebView2 中安裝 CRX。 (僅執行時)

  • 修正了應用程式套用 DPI 意識相容性設定時的初始化失敗。 (僅執行時) (#3008)

  • 修正了一個視覺託管自有視窗無法接收字元輸入的錯誤。 (僅執行時)

1.0.1901.177

上映日期：2023年7月24日

NuGet package for WebView2 SDK 1.0.1901.177

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 115.0.1901.177 或以上。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • NavigationKind 會取得每個導覽的導覽類型，例如返回/前進、重新載入或導向新文件。
  • ServiceWorkers enum 中的 BrowsingDataKinds enum 值指定了為來源註冊的服務工作者。

Bug 修正

  • 修正了一個錯誤，當同時隱藏書籤、搜尋和頁面選擇器按鈕時，整個工具列會是空白的。 (僅執行時) 第2866期

1.0.1988-預發布

上映日期：2023年7月24日

NuGet 套件用於 WebView2 SDK 1.0.1988-prerelease

為完整 API 相容性，此 WebView2 SDK 預發布版本需使用 Microsoft Edge 版本 117.0.1988.0 或更高版本所附的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 支援透過 WebView2 的桌面通知：
  • 支援透過取得 iframe 的程序資訊細節來監控 iframe 的執行時記憶體使用情況。
  • 支援 WebView2 的擴充功能。
  • TextDirectionKind列舉指定文字方向為左至右或右至左。

Bug 修正

  • 修正 CoreWebView2Frame.ExecuteScriptAsync 了當幀在腳本執行時被銷毀時發生的當機。 第3124期

  • 在重定向後閱讀WebResourceResponse內容時修正了 aCOMException。 第3229期

  • 修正了一個迴歸問題，因為同一個名字會重複呼叫 CoreWebView2.AddHostObjectToScript 會卡住。 (僅限運行時) 第3539期

  • 修正 PrintAsync 了包含中文字符時 PrinterName 會失敗的問題。 第3379期

  • 修正了在將列印頁面 AreDefaultContextMenusEnabled 設定為 false時，關閉右鍵選單的問題。 第3548期

  • 移除了網頁擷取右鍵選單中的視覺搜尋功能。 (僅限運行時間) 第 3426期

  • 修正了一個在列印設定為 null. 時會導致PrintAsync且PrintToPdfStreamAsync失敗的問題。

  • 移除了預設「無網路連線」錯誤頁面的「啟動遊戲」按鈕。 (僅執行時)

  • 修正了一個問題，確保可以從 UNC 路徑載入。WebVivew2Loader 第3465期

  • 固定、無效 CoreWebView2PdfToolbarItems.FullScreen 且 CoreWebView2PdfToolbarItems.MoreSettings。

  • 新增了多執行緒存取主機物件的鎖。 (僅執行時)

  • 固定的設定選項 () CoreWebView2PdfToolbarItems.MoreSettingsCoreWebView2PdfToolbarItems.FullScreen 在 PDF 預覽模式下不適用。 第3324期

  • 移除了 PDF 設定中的 「隱藏所有註解 」 選項，還有更多功能。 (僅執行時)

  • 移除了 「顯示所有已儲存密碼」 的右鍵選單項目。 (僅執行時)

1.0.1823.32

發行日期：2023年6月5日

NuGet package for WebView2 SDK 1.0.1823.32

為了完整 API 相容性，本版本的 WebView2 SDK 需 WebView2 執行時版本 114.0.1823.32 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • LaunchingExternalUriScheme當嘗試啟動一個已註冊於作業系統 (外部 URI 方案) 時，該事件會被觸發。
  • MemoryUsageTargetLevel 指定記憶體使用等級，例如 low 或 normal。
  • 強化對多個設定檔的支援，允許設定不同設定檔的一般自動填充與密碼自動儲存設定。

1.0.1905-預發布

上映日期：2023年6月12日

NuGet 套件用於 WebView2 SDK 1.0.1905-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 116.0.1905.0 或更高版本的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

本預發布 SDK 中未新增任何實驗性 API。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • NavigationKind 會取得每個導覽的導覽類型，例如返回/前進、重新載入或導向新文件。
  • ServiceWorkers enum 中的 BrowsingDataKinds enum 值指定了為來源註冊的服務工作者。
  • LaunchingExternalUriScheme當嘗試啟動一個已註冊於作業系統 (外部 URI 方案) 時，該事件會被觸發。
  • MemoryUsageTargetLevel 指定記憶體使用等級，例如 low 或 normal。

Bug 修正

  • 在列舉某些webhosthidden類型時，使用wv2winrt webhosthidden進入了無限迴圈。 (僅支援 SDK)

  • 在 wv2winrt 工具產生的程式碼中，當呼叫非同步方法時，如果成功但回傳nullIAsyncAction的是 . (僅支援 SDK)

1.0.1774.30

上映日期：2023年5月8日

NuGet 套件 for WebView2 SDK 1.0.1774.30

為了完整 API 相容性，此版本的 WebView2 SDK 需要 WebView2 執行時版本 113.0.1774.30 或以上。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 檔案 API 允許存取透過 WebMessage傳遞的 DOM File 物件。
  • Profile Cookie Manager API 支援設定檔管理。 這個 CookieManager 屬性讓主機應用程式能夠取得該設定檔的 cookie 管理器。

Bug 修正

  • 修正了一個問題，讓應用程式能在建立新視窗前呼叫 AddScriptToExecuteOnDocumentCreated 注入初始腳本。 (第#2491號)
  • 修正了一個導致 X-Edge-Shopping-Flag 標頭被加入來自 WebView2 的網頁請求的問題。 (僅執行時) (第3365號)

1.0.1829-預釋版本

上映日期：2023年5月8日

NuGet 套件用於 WebView2 SDK 1.0.1829-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 版本 115.0.1829.0 或更高版本附帶的 WebView2 執行環境。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 強化對多個設定檔的支援，允許設定不同設定檔的一般自動填充與密碼自動儲存設定。

Bug 修正

  • 關閉了顯示允許安裝擴充功能的 Chrome 網路商店資訊橫幅。 (第#3312期)

  • 修正了自訂選單項目無法觸發的問題。 (第3300期)

  • 已修正使用 WPF 和 SDK 版本 1.0.1722.32 建立 WebView2 初始化時的當機，該版本現已不再棄用。 (請參閱以下 SDK 1.0.1722.32 已被棄用 。) (問題 #3375)

  • 修正了一個在發布約 32000x1MB 緩衝區後停止的錯誤 PostSharedBufferToScript 。 (僅執行時) (#3360)

  • 修正了一個導航總是在事件回調中 ScriptDialogOpening 發生的問題。 (僅執行時) (第3355號)

  • 修正了一個支援 BackForwardCache 旗幟的問題。 (僅執行時)

  • 修正了 Visual Host 擁有視窗的問題，從視窗外點擊搜尋欄時，搜尋欄無法啟動。

1.0.1722.45

上映日期：2023年4月13日

NuGet 套件 for WebView2 SDK 1.0.1722.45

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 112.0.1722.45 或以上。

SDK 1.0.1722.32 已棄用

WebView2 SDK 1.0.1722.32 已棄用，該套件也已從 NuGet 的商品列表中移除。 停止使用 1.0.1722.32 套件的開發。 如果您的 WebView2 應用程式使用該套件，建議您轉換到更新的套件，例如 WebView2 SDK 1.0.1722.45 或更新版本。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 管理 SmartScreen API 控制是否啟用 SmartScreen。
  • API 會 PermissionKind.WindowManagement 標示權限請求的類型。

1.0.1777-預發布

上映日期：2023年4月10日

NuGet 套件用於 WebView2 SDK 1.0.1777-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 114.0.1777.0 或更高版本所附的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

本預發布 SDK 中未新增任何實驗性 API。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 檔案 API 允許存取透過 WebMessage傳遞的 DOM File 物件。
  • Profile Cookie Manager API 支援設定檔管理。 這個 CookieManager 屬性讓主機應用程式能夠取得該設定檔的 cookie 管理器。

Bug 修正

  • 從另一個討論串釋出 WebView 時，已經修正了當機的問題。 (僅執行時) (第#3062)

  • 修正了一個錯誤，當焦點被 WebView2 控制項包裹 ContainerControl時，會被困在 . (第#2835號)

  • 透過停用 WebView2 中可 .pdf 編輯的臨時快取資料恢復功能，解決了這個問題。 (第#3274期)

  • 關閉了顯示允許安裝擴充功能的 Chrome 網路商店資訊橫幅。 (第#3312期)

  • 修正了螢幕閱讀器無法指出新下載項目的問題。

  • 修正了一個視覺化主機自有視窗無法正確映射滑鼠指標輸入的錯誤。

  • 修正了一個因為取消另存新檔對話框而出現的錯誤DownloadStarting。 (僅執行時)

1.0.1661.34

上映日期：2023年3月20日

NuGet package for WebView2 SDK 1.0.1661.34

為完整 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 111.0.1661.34 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • The SharedBuffer API:
  • 權限管理的 API：

管理追蹤預防的 API：

  • 管理控制器腳本區域值的 API：

1.0.1724-預發布

上映日期：2023年3月20日

NuGet 套件 for WebView2 SDK 1.0.1724-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 版本 113.0.1724.0 或更高版本附帶的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增 AdditionalObjects 給收到的 WebMessage 內容：
  • 新增視窗管理權限類型：
  • 新增支援啟動外部 URI：
  • 新增對貼圖串流的支援：

回傳TextureStream介面的介面：Environment

介面：TextureStream

ErrorReceivedEventArgs：

WebTextureReceivedEventArgs：

TextureStream 錯誤類型列舉：

Texture主機寫入的介面，讓渲染器會在上面渲染：

渲染器寫入以讓主機讀取的接收 WebTexture 介面：

  • 新增對設定檔管理的支援：自訂資料分割區、Cookie 管理器及設定檔刪除：

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 管理智慧螢幕 API：

Bug 修正

  • 修正了一個 PrintAsync 錯誤，當 PrintToPdfStreamAsync 列印設定為 null 時會拋出例外。

  • 提升了高架運行應用程式的處理能力。 (僅執行時)

  • 新增了對視窗管理權限類型的支援。 (執行時與 SDK)

  • 可靠性提升。 (僅執行時)

1.0.1587.40

發行日期：2023年2月15日

NuGet 套件 for WebView2 SDK 1.0.1587.40

為完整 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 110.0.1587.40 或以上。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 用於建立 WebView2 環境以管理自訂方案註冊的額外選項：

1.0.1671-預釋版本

發行日期：2023年2月15日

NuGet 套件用於 WebView2 SDK 1.0.1671-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 112.0.1671.0 或更高版本所附的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增對實驗檔案 API 的支援：

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • The SharedBuffer API:
  • 許可 API：
  • The ScriptLocale API:

Bug 修正

  • 修正了一個 WebView2 在收到事件時 BeforeUnload 無法正常關閉的錯誤。 (僅執行時) (第2677期)

  • DownloadStarting結果是，之前的 ResultFilePath UWP 應用程式下載位置在附加事件處理器時DownloadStarting沒有顯示正確位置。 這點已經修正; ResultFilePath 正確結果現在顯示出來。

  • 修正了一個錯誤，當 System.ArgumentException 呼叫 HostObject 方法時會回傳非通用任務。 (第2787期)

  • 修正了 API 中 SharedBuffer 串流物件 StreamWriter與 . (僅執行時) (#3108)

  • DOM 語音合成 API，例如 SpeechSynthesis.getVoices()，現在可以在 UWP 應用程式中運作。 (僅執行時)

  • 修正了在幀毀損時發生的當機。 (僅執行時) (第#3062)

  • 修正了一個 app 在嘗試用nullreason短語通話CreateWebResourceResponse時當機的 bug。 (僅執行時)

  • CoreWebView2.AddHostObjectToScript這個選項chrome.webview.hostObjects.options.ignoreMemberNotFoundError現在在非英語地區也能使用。 (僅執行時)

  • Windows 7 上提升級應用程式完全啟用 開啟檔案 對話框。

  • 修正了一個 UWP 中已擁有視窗不會出現的錯誤。

1.0.1518.46

上映日期：2023年1月17日

NuGet 套件 for WebView2 SDK 1.0.1518.46

為完全 API 相容性，此版本的 WebView2 SDK 需 WebView2 執行時版本 109.0.1518.46 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 列印 API：
  • 自訂崩潰報告 API：

1.0.1619-預釋版本

發行日期：2023年1月19日

NuGet 套件 for WebView2 SDK 1.0.1619-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 版本 111.0.1619.0 或更高版本附帶的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增對權限管理 API 的支援：
  • 新增支援 API 以停用前後導覽：

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 自訂方案註冊 API：
  • 追蹤預防 API：

Bug 修正

  • 在 WebView2 右鍵選單中停用「 以個人檔案開啟連結 」。

  • 修正了表格中缺少的貼文資料，請用 Ctrl 點擊提交。 (第#2652號)

  • 已修正一個使用者無法在 PDF 檢視器中取得自訂右鍵選單的錯誤。 (第2607號)

  • 修正了一個錯誤，當同時隱藏 書籤、 搜尋和 頁面選擇器 按鈕時，整個工具列會是空白的。 (第2866期)

  • 修正了一個 Bug ，就是當 Windows 關閉時，嘗試將焦點移到 WebView2 時會當機。

  • WebView2 內固定拖放功能，適用於構圖託管的 WebView。

  • 移除了 WebView2 彈出視窗中地址列的朗讀圖示。

  • 修正了 WebView2 彈出視窗右鍵選單中的意外項目。

1.0.1462.37

上映日期：2022年12月12日

NuGet package for WebView2 SDK 1.0.1462.37

為了完整 API 相容性，本版本的 WebView2 SDK 需要 WebView2 執行時版本 108.0.1462.37 或以上。

Bug 修正

這個 WebView2 SDK 版本的錯誤修正與 1.0.1466 預發布版本的錯誤修正相同。

1.0.1549-預發布

上映日期：2022年12月12日

NuGet 套件 for WebView2 SDK 1.0.1549-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 110.0.1549.0 或更高版本的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增對區域區域 API 的支援：
  • 新增對追蹤防護 API 的支援：

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 新增對列印 API 的支援：
  • 新增對自訂崩潰報告 API 的支援：

Bug 修正

  • 修正了一些 nullptr 的問題，現在有些公開 API 如果以 nullptr 作為輸入參數，也不會讓 WebView2 當機。

  • 在 WebView2 的右鍵選單中關閉了「以個人檔案開啟連結」功能。

  • 修正了當同時隱藏書籤、搜尋和頁面選擇器按鈕時，整個工具列會是空白的錯誤。 (第2866期)

  • 用 Control Click 修正表格提交中缺少的貼文資料。 (第#2652號)

  • 已修正一個使用者無法在 PDF 檢視器中取得自訂右鍵選單的錯誤。 (第2607號)

  • 修正 WebView2 內的拖放功能，適用於構圖託管的 WebView。

  • 修正了一個 Bug ，就是當 Windows 關閉時，嘗試將焦點移到 WebView2 時會當機。

  • 在 WebView2 彈出視窗的地址列移除朗讀圖示。

  • 修正了 WebView2 彈出視窗中右鍵選單顯示意外項目的問題。

1.0.1418.22

上映日期：2022年10月31日

NuGet 套件 for WebView2 SDK 1.0.1418.22

為了完整 API 相容性，本版本的 WebView2 SDK 需要 WebView2 執行時版本 107.0.1418.22 或更高。

Bug 修正

這個 WebView2 SDK 版本的錯誤修正與 1.0.1414 預發布版的錯誤修正相同。

1.0.1466-預發布

上映日期：2022年10月31日

NuGet 套件 for WebView2 SDK 1.0.1466-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 109.0.1466.0 或更高版本的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增支援建立指定大小的共享記憶體緩衝區：
  • 新增支援從主框架腳本存取共享緩衝區物件，或 iframe：
  • 新增支援從目前頂層文件中 JavaScript 參數執行 JavaScript 程式碼：

1.0.1466 預釋版的錯誤修正

  • 修正了一個列印設定中自訂標題可能錯誤的錯誤。 (第#2093號)

  • 以串Base64列形式顯示。AllowedCertificateAuthoritiesadd_ClientCertificateRequested (僅執行時) (第2346號)

  • 修正了一個列印設定中預設頁尾 URI 缺失的錯誤。 (第#2851號)

  • 修正了一個產生空指標異常的錯誤，該異常與列印設定有關。 (僅執行時) (第#2858號)

  • 修正了一個錯誤，該錯誤在重新導向已設定為客戶端憑證認證 WebResourceRequested 的伺服器時，且事件被訂閱時會報告導航失敗。 (僅執行時)

  • 修正了一個 AddHostObjectToScript 錯誤，當 JavaScript 呼叫一個非同步方法，接著呼叫同步方法時，非同步方法呼叫可能會失敗。

1.0.1370.28

上映日期：2022年10月11日

NuGet 套件 for WebView2 SDK 1.0.1370.28

為完整 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 106.0.1370.28 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 拖放式 API：

1.0.1414-預發布版本

上映日期：2022年10月11日

NuGet 套件 for WebView2 SDK 1.0.1414-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 版本 107.0.1414.0 或更高版本附帶的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增對列印 API 的支援：
  • 新增對 SmartScreen API 的支援：
  • 新增對自訂崩潰報告 API 的支援：

1.0.1414 預發布版的錯誤修正

  • 已移除下載頁面中帶有斷裂連結的三點選單。 (僅執行時) (第2753號)

  • 修正了 WebView2 WinRT JS 投影工具 (wv2winrt) 中 C++20 專案無法編譯的錯誤。 (第2768期)

  • 修正了當你訂閱任何事件，特別是該 CoreWebView2.GetDevToolsEventReceiver 事件時，關閉 WebView2 WinRT API 時可能發生的當機。 (僅支援 SDK)

  • 修正了一個 bug，就是最小化視窗後無法關閉下載彈窗。 (僅執行時)

1.0.1343.22

上映日期：2022年9月6日

NuGet package for WebView2 SDK 1.0.1343.22

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 105.0.1343.22 或以上。

Bug 修正

這個 WebView2 SDK 版本的錯誤修正與 1.0.1369 預發布版本的錯誤修正相同。

1.0.1369-預釋版本

上映日期：2022年9月6日

NuGet 套件 for WebView2 SDK 1.0.1369-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 版本 106.0.1369.0 或更高版本附帶的 WebView2 執行環境。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 拖放式 API：

1.0.1369 預發布版的錯誤修正

  • 修正了一個 WPF 應用程式在關閉 Windows 與 WebView2 時會當機的錯誤。 (第640期)

  • 修正了一個導致同時 WebView 建立失敗的錯誤。 (僅執行時) (第2703號)

  • 固定列印設定紙張尺寸，以支援最小至 0.01 吋的尺寸。 (僅執行時)

  • 修正了一個 WebView2 列印對話框每次都把 縮放 設定重設成 可列印區域 的錯誤。 (第2523號)

  • 修正了 wv2winrt 工具中的一個錯誤，有些專案中沒有引用 WinMD 檔案。

1.0.1293.44

上映日期：2022年8月8日

NuGet 套件 for WebView2 SDK 1.0.1293.44

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 104.0.1293.44 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • The Favicon API:

1.0.1340-預發布

上映日期：2022年8月8日

NuGet 套件 for WebView2 SDK 1.0.1340-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 版本 105.0.1340.0 或更高版本附帶的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增了對 WebResourceRequested workers 的支援，允許設定過濾器以接收 WebResourceRequested 服務工作者、共享工作者及不同起源 iframe 的事件。
  • 新增對自訂方案註冊的支援，使 WebView2 應用程式能處理 WebResourceRequested 指定方案下的請求事件，並能透過 WebView2 控制項導航至自訂方案。

Bug 修正

  • 新增了開發者能明確指定載入 WebView2Loader.dll 路徑的功能。 (第#767號)

  • 使用 CallDevToolsProtocolMethod時新增了有用的錯誤訊息。 (第#1609號)

  • 修正了某些 .NET 應用程式中尋找並載入 S 的 WebView2Loader.dll 錯誤。 (第2372號)

  • 修正了一個重新 DownloadStarting 嘗試下載時事件未觸發的錯誤。 (第#2489號)

  • 修正了如果路徑太長，服務人員快取的問題。 (第#1900號)

  • 提升 了 wv2winrtIMap 及 IMapView JavaScript 投影的效能。

  • 新增支援 HWND_MESSAGE 作為 WebView2 父視窗，以支援無頭場景。 (第#202號)

  • 改進了以管理員使用者應用程式執行的處理。

  • 在 UWP 應用程式中使用 WebView2 時，已修正線上/離線狀態及通知。

  • 現在可以啟用 WebView2 的 GDI 縮放功能。 WebView2 將尊重主機應用程式的 GDI 縮放設定，無需額外工作。 (第#1700期)

  • 修正了一個錯誤，關閉視窗模式的搜尋欄後，焦點無法回到應用程式。 (第#1225號)

1.0.1264.42

發行日期：2022年7月4日

NuGet 套件 for WebView2 SDK 1.0.1264.42

為完整 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 103.0.1264.42 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 新增 ContextMenuRequested了 API，讓主機應用程式能自行建立或修改自己的右鍵選單。

1.0.1305-預釋版本

發行日期：2022年7月4日

NuGet 套件 for WebView2 SDK 1.0.1305-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 105.0.1305.0 或更高版本的 WebView2 執行時。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • The Favicon API:

Bug 修正

  • 修正了一個可能卡住很久的問題 PrintToPdfAsync 。 (第#1974期)
  • 固定迴歸，當 WebView2 顯示時，WebView2 會從應用程式中搶走焦點。 (第#862號)

1.0.1245.22

發行日期: 2022 年 6 月 14 日

NuGet package for WebView2 SDK 1.0.1245.22

為完全 API 相容性，此版本的 WebView2 SDK 需 WebView2 執行時版本 102.0.1245.22 或更高。

沒有對應的預發行套件。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • 伺服器憑證 API，提供在應用程式層級信任伺服器 TLS 憑證的選項。 它能呈現頁面，且不會提示使用者關於 TLS 或取消網頁請求的功能。

  • ClearBrowsingData API 允許開發者在一定期間內以程式方式清除特定資料型態：

    • ClearBrowsingData
    • ClearBrowsingDataAll
    • ClearBrowsingDataInTimeRange

  • HttpStatusCode API 提供事件中NavigationCompleted導航請求的 HTTP 狀態碼。

Bug 修正

  • 修正了螢幕鍵盤關閉後點擊 X 鍵後鍵盤不會重新出現的問題。 也修正了使用者在 WebView2 中切換編輯控制時，鍵盤會被關閉的問題。 (第460期)

  • 在腳本中使用代理 AddHostObjectToScript 時修正了問題。 如果你呼叫 setHostProperty 失敗，你可能會收到內部錯誤訊息結構，而不是 JavaScript 錯誤物件。

  • 固定迴歸，當 WebView2 顯示時，WebView2 會從應用程式中搶走焦點。 (第#862號)

  • 修正了一個導致使用大量資料事件 WebResourceRequested 記憶體使用增加的錯誤。 (第#2171期)

  • 固定 StatusBarTextChanged 迴歸。 StatusBarText API 再次與先前版本相容。 (第#2414號)

  • 對以管理員身份執行的應用程式提供更好的支援。 (問題 #2356)

1.0.1210.39

上映日期：2022年5月9日

NuGet package for WebView2 SDK 1.0.1210.39

為完全 API 相容性，此版本的 WebView2 SDK 需 WebView2 執行時版本 101.0.1210.39 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

1.0.1248-預釋版本

上映日期：2022年5月9日

NuGet 套件 for WebView2 SDK 1.0.1248-prelease

為完整 API 相容性，此 WebView2 SDK 預發布版本需使用 Microsoft Edge 版本 102.0.1248.0 或更高版本的 WebView2 執行環境。

一般功能

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • Server Certificate API 提供一個選項，可以在應用程式層級信任伺服器的 TLS 憑證，並在不提示使用者關於 TLS 或取消網頁請求的情況下呈現頁面。

  • ClearBrowsingData API 允許開發者在一定期間內以程式方式清除特定資料型態：

    • clearBrowsingDataInTimeRange
    • clearBrowsingDataAll

Bug 修正

  • 修復了 WPF 控制 OnWindowPositionChanged 事件中發生的無法避免的當機。 (第#1531號)

  • 解決 CoreWebView2EnvironmentOptions.ExclusiveUserDataFolderAccess 了 .NET SDK 無法正常運作的問題。 (第#2363號)

  • 修正了執行時的回歸問題，導致使用主機物件的 Office 外掛在先前運作的操作中當機。 (第#2337期)

  • 修正了 WebView2 內容在不同縮放螢幕間移動時會變得模糊的問題。

  • 修正了迴歸問題，確保 WebView2 建立時會快速失敗，而不是以 HRESULT_FROM_WIN32(ERROR_INVALID_STATE) 逾時。

  • 修正了一個 Chromium 變更導致 WebView2 背景顏色受損的錯誤。

1.0.1185.39

發行日期: 2022 年 4 月 12 日

NuGet 套件 for WebView2 SDK 1.0.1185.39

為了完整 API 相容性，本版本的 WebView2 SDK 需要 WebView2 執行時版本為 100.0.1185.39 或更高。

一般功能

  • 更名為 ICoreWebView2CertificateICoreWebView2ClientCertificate。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

1.0.1222-預釋版本

發行日期: 2022 年 4 月 12 日

NuGet 套件用於 WebView2 SDK 1.0.1222-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 102.0.1222.0 或更高版本的 WebView2 執行環境。

1.0.1222 預發布版的實驗性 API

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增了 伺服器憑證 API ，提供在應用程式層級信任伺服器 TLS 憑證的選項，並在不提示使用者關於 TLS 或取消網頁請求的情況下呈現頁面。

  • 新增了 Favicon API ，提供網站 favicon 變更或設定時取得的方法。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

Bug 修正

  • 固定 ZoomFactor 問題，當值超出範圍時，錯誤地將數值設 ZoomFactor 為最大值。

  • 修正了 WebView2 內容在不同縮放螢幕間移動時會變得模糊的問題。

  • 修正了一個 在視覺主機模式下 和 MouseEvent.movementY 永遠是 0 的錯誤MouseEvent.movementX。 (第2220期)

  • 已修正因 WebView2 密碼回溯所導致的登入問題。 (第2291期)

  • 修正了使用者開啟新應用程式視窗時，網頁未被指派導航條目時所造成的失敗。

  • 我做了執行時的修改，修正 WinUI 2 (UWP) 中擁有視窗無法顯示的錯誤。

  • 更新原始碼後功能已修正 ICoreWebView2Frame::PostWebMessage 。 (第2267號)

1.0.1150.38

發行日期：2022年3月10日

NuGet package for WebView2 SDK 1.0.1150.38

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 99.0.1150.38 或以上。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

1.0.1189-預釋版

發行日期：2022年3月10日

NuGet 套件用於 WebView2 SDK 1.0.1189-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 100.0.1189.0 或更高版本的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

Bug 修正

  • 修正了一個 WebView2 應用程式偶爾卡在 UWP 的錯誤。

  • 修正了一個錯誤，關閉視窗模式的 搜尋 欄後，焦點不會回到應用程式。

  • 修正了單頁應用程式中事件未被觸發以進行前後導航的錯誤 DocumentTitleChanged 。

  • 已修正 HistoryChanged 事件未被觸發用於 Iframe 導航的錯誤。

1.0.1108.44

上映日期：2022年2月6日

NuGet 套件 for WebView2 SDK 1.0.1108.44

為完整 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 98.0.1108.44 或以上。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • AdditionalAllowedFrameAncestors API 讓開發者能提供額外的允許框架祖先。

  • ProcessInfo API 提供更多關於 WebView2 程序及流程集合的資訊。

  • 新的 iframes API：

    • add_NavigationStarting
    • remove_NavigationStarting
    • add_ContentLoading
    • remove_ContentLoading
    • add_NavigationCompleted
    • remove_NavigationCompleted
    • add_DOMContentLoaded
    • remove_DOMContentLoaded
    • ExecuteScript
    • PostWebMessageAsJson
    • PostWebMessageAsString
    • add_WebMessageReceived
    • remove_WebMessageReceived

1.0.1158-預釋版本

上映日期：2022年2月6日

NuGet 套件用於 WebView2 SDK 1.0.1158-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 版本 100.0.1158.0 或更高版本的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增 狀態列 API ，當 webiew 顯示狀態訊息、URL 或空字串時，提供資訊。

  • 新增 CDP API ，讓開發者在 WebView2 中擁有多重 DevToolsProtocol 目標。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

Bug 修正

  • 修正了 Visual Studio 錯誤清單視窗中錯誤警告的問題。 (第#1722號)

  • 修正了一個 NewWindowRequested 在開啟 PDF 下載時沒有被提升的錯誤。

  • 已解決 WinUI 3 中的一個錯誤，選定下拉選單無法顯示。 (第#1693期)

  • 新增了即使沒有音訊播放時，也能切換 WebView2 靜音狀態的功能。

1.0.1072.54

發行日期: 2022 年 1 月 13 日

NuGet package for WebView2 SDK 1.0.1072.54

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 97.0.1072.54 或以上。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

  • Media API 讓開發者能在 WebView2 中靜音或解除靜音媒體。

  • 下載定位與錨定 API 可啟用：

    • 改變下載對話框相對於 WebView2 邊界的位置。 你可以將下載對話框固定在 下載 按鈕上，而非預設位置右上角。
    • 用程式方式開啟並關閉預設下載對話框。
    • 根據對話的開頭和結束做出調整。

1.0.1133-預釋版本

發行日期: 2022 年 1 月 13 日

NuGet 套件 for WebView2 SDK 1.0.1133-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要使用 Microsoft Edge 99.0.1133.0 或更高版本所附的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • 新的 iframes API：
    • PostWebMessageAsJson
    • PostWebMessageAsString
    • add_WebMessageReceived
    • remove_WebMessageReceived
  • ProcessInfo API 提供更多關於 WebView2 程序 及 流程集合的資訊。
  • HTTP 認證 API。

Bug 修正

  • 修正了一個導致事件中無法 Set-Cookies 顯示 WebResourceResponseReceived 標題的錯誤。

  • 解決了一個錯誤，彈出視窗和擁有視窗會在關閉前跳到不同位置，而不是跟著應用程式視窗一起關閉。 這個漏洞只在非常短的時間內活躍。

  • 關閉檔案選取器對話框後，已修正焦點問題。

  • 修正了「頁面尋找」介面可見性在 WebView2 顯示時沒有改變的錯誤。

  • 修正了無法定位/載入WebView2Loader.dll的錯誤GetAvailableBrowserVersionString()。 (第#1236號)

  • 新視窗的固定大小與位置，並根據 window.open 未處理事件時 NewWindowRequested 產生。 (第#1343期)

  • 修正了關閉右鍵選單時，選擇文字上仍顯示迷你選單的錯誤。 此變更是針對執行時的特性。 (第#1345號)

  • 已修正 WinForms 切換應用程式後焦點回到錯誤位置的錯誤。

1.0.1083-預釋版本

上映日期：2021年11月29日

NuGet 套件用於 WebView2 SDK 1.0.1083-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 版本 97.0.1083.0 或更高版本附帶的 WebView2 執行環境。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 在 WebView2 中新增了 以下 iframes API ：

    • PostWebMessageAsJson
    • PostWebMessageAsString
    • add_WebMessageReceived
    • remove_WebMessageReceived

  • 新增 ProcessInfo API，提供更多關於 WebView2 流程 及 流程集合的資訊。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • Media API 讓開發者能在 WebView2 中靜音或解除靜音媒體。
  • 下載定位與錨定 API。 此 API 可實現：
    • 改變下載對話框相對於 WebView2 邊界的位置。 你可以將下載對話框固定在 下載 按鈕上，而非預設位置右上角。
    • 程式化地開啟並關閉預設下載對話框。
    • 根據對話的開頭和結束做出調整。

Bug 修正

  • 關閉檔案選擇器對話框後修正了焦點問題。

  • 修正了一個 WebView2 在初次啟動時無法接收空間輸入的錯誤。

  • 已修正 WebView2 中無法支援單一登入的問題。

  • 解決了一個 WPF 和 WinForms 的下載對話框無法移動的錯誤。

  • 更新相容的命令列檢查，避免對可選交換器進行版本檢查。

  • 修正了一個錯誤，導致「Microsoft Edge」品牌出現在無障礙工具樹中。

1.0.1054.31

上映日期：2021年11月29日

NuGet package for WebView2 SDK 1.0.1054.31

為完全 API 相容性，此版本的 WebView2 SDK 需 WebView2 執行時版本 96.0.1054.31 或以上。

Bug 修正

  • 一般可靠性修正。

  • 關閉了 CET (控制流強制技術) v96 WebView2 執行時的 Shadow Stack 功能。

  • 修正了在 .NET 單檔案應用程式啟動時導致啟動緩慢的問題。 (第#1909期)

  • 也修正了 Microsoft Edge 瀏覽器政策錯誤套用到 WebView2 導致的當機。 (第#1860期)

  • 修正了當一個彈出視窗關閉下載對話框時發生的當機。 (第#1765期) & (第#1723期)

1.0.1056-預發布

上映日期：2021年10月29日

NuGet 套件 for WebView2 SDK 1.0.1056-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要隨 Microsoft Edge 97.0.1056.0 或更高版本附帶的 WebView2 執行時。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 下載定位與錨定 API。 此 API 可實現：
    • 改變下載對話框相對於 WebView2 邊界的位置。 你可以將下載對話框固定在 下載 按鈕上，而非預設位置右上角。
    • 程式化地開啟並關閉預設下載對話框。
    • 根據對話的開頭和結束做出調整。

Bug 修正

  • 一般可靠性改善。

  • 現在會提供真正的程序退出代碼，表示 ExitCodeICoreWebView2ProcessFailedEventArgs2COREWEBVIEW2_PROCESS_FAILED_KIND_BROWSER_PROCESS_EXITED 程序失敗。

  • --js-flags該交換現在在 中提供的 CoreWebView2EnvironmentOptionsTHAT 中被AdditionalBrowserArguments尊重。

  • JavaScript 中對宿主物件的屬性有固定存取 name 權限。 (第#641期)

  • 修正了 WPF InvalidCastException 控制點在事件迴圈開始前被隱式初始化的問題。 (第#1577號)

1.0.1020.30

上映日期：2021年10月25日

NuGet 套件 for WebView2 SDK 1.0.1020.30

為完整 API 相容性，此版本 WebView2 SDK 需 WebView2 執行時版本 95.0.1020.30 或以上。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

Bug 修正

  • 已更新 EnsureCoreWebView2Async 為在 WPF 原始碼屬性設定時不會拋出例外。 (第#1781期)

  • 修正了一個 WebView2 在與多個顯示下載介面的視窗互動後當機的錯誤。 (第#1723期)

1.0.992.28

上映日期：2021年9月27日

NuGet package for WebView2 SDK 1.0.992.28

為完整 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 94.0.992.31 或以上。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

Bug 修正

  • 已修正缺少 WebView2 DLL (，該問題導致初始化失敗) 當 PlatformTarget 使用者的 .NET 專案中未設定時。 (第#1061期)

1.0.1018-預釋版本

上映日期：2021年9月20日

NuGet 套件 for WebView2 SDK 1.0.1018-prerelease

為了完整 API 相容性，此預發布版本的 WebView2 SDK 需要 Microsoft Edge 版本 95.0.1018.0 或更高版本。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

  • 新增了一個 媒體 API ，讓開發者能在 WebView2 中靜音或解除靜音媒體。

  • 新增支援 WebView2 的 多用戶設定檔 。

Bug 修正

  • 修正了一個 WebView2 在應用程式跨螢幕時停止渲染且螢幕縮放改變的錯誤。

  • 修正了一個錯誤，關閉下載介面時，當多個下載視窗開啟時，WebView2 當機。 (第#1723期)

  • 修正了當 PlatformTarget 未設定在使用者的 .NET 專案中時的建置/初始化錯誤。 (第#730期 與 第#1548期)

1.0.1010-預釋版本

發行日期：2021 年 9 月 14 日

NuGet 套件 for WebView2 SDK 1.0.1010-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要 Microsoft Edge 版本 95.0.1010.0 或以上。

一般功能

  • WebView2 效能提升。
  • 可靠性修正。 (第#1605期 與 第#1678期)
  • 在啟動時以及主機應用程式在前景時，會額外提升效能。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

  • IsSwipeNavigationEnabled
  • BrowserProcessExited
  • OpenBrowserTaskManager

Bug 修正

  • 改善了 JavaScript 程式碼中捕捉宿主物件例外的方式。

  • 在 DevTools 視窗中將 WebView2 圖示換成通用圖示。

  • 使用時 MediaDevices.getDisplayMedia() 請開啟分頁螢幕共享選項。 (第#1566期)

  • 修正了客戶端憑證 API 的一個錯誤，當沒有選擇正確的憑證時。 這是執行時間的變更。 (第#1666期)

  • 修正了在同一父網域的新視窗中無法使用的錯誤 window.chrome.webview 。 此變更是針對執行時的特性。 (第#1144期)

  • 修正了一個錯誤，就是在有焦點視窗後方會顯示下拉選單或清單。 (第411期)

  • 使用 put_IsVisible(false)時的固定焦點問題。 (第238期)

  • 修正了一個可以套用 SetVirtualHostNameToFolderMapping 到彈出視窗的錯誤。

  • 修正了物件 IDispatch 回傳為 IUnknown的錯誤。

1.0.961.33

發行日期：2021年9月8日

NuGet package for WebView2 SDK 1.0.961.33

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 93.0.961.44 或更高。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

Bug 修正

  • 修正了一個導致 ERR_SSL_CLIENT_AUTH_CERT_NEEDED 錯誤的錯誤。 這是執行時間的變更。

  • 修正了一個 bug，就是像是刷新、主頁、返回等特殊瀏覽器按鍵無法用 AreBrowserAcceleratorKeysEnabled. 此變更是針對執行時的特性。

  • 修正了一個透明背景色沒有被渲染的錯誤。

  • 修正了載入 WebView2 時導致白色閃爍的錯誤。

  • 修正了 WebView2 .NET 控制項中的一個錯誤，當時在背景建立 WebView2 視窗時是空白的。 (第#1077期)

  • 修正了一個錯誤，使用者在瀏覽或新視窗顯示 about:blank 頁面時設定未更新。 這是執行時間的變更。

1.0.955-預發布

上映日期：2021年7月26日

NuGet 套件 for WebView2 SDK 1.0.955-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要 Microsoft Edge 版本 93.0.967.0 或更高版本。

一般功能

  • WebView2 效能提升。
  • 新增部分事件追蹤支援 Windows (ETW) 支援。
  • 已移除 Microsoft 品牌。edge://history
  • 新的預設下載介面。

預發布 (中晉升為第一階段實驗)

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

Bug 修正

  • 已修正導致頁面崩壞的edge://downloadsedge://history錯誤。 此變更是針對執行時的特性。

  • 修正錯誤以提升 WebView2Loader.dll 的可靠性。

  • 修正了 NewWindowRequested 事件處理程序在處理使用連結 target=_blank時啟動兩個視窗的錯誤。

  • 修正了 WebView2 視覺化主機在啟動前閃爍的一個錯誤。

  • 已修正 WebView2 控制add_NewWindowRequested項無法運作的錯誤add_WebResourceRequested。 (第#616期)

  • 允許主機應用程式在其他應用程式中針對包括 NavigationStarting、 方法 AddHostObjectToScript 、 WebMessageReceived和 NewWindowRequested等事件設定前景。 (第#1092號)

  • 修正觸發 PermissionRequested 麥克風事件的錯誤。 此變更僅限執行時。 (議題 #1462)

  • 在多次成功跑關後被阻擋時修正了這個錯誤 ExecuteScriptAsync 。 此變更是針對執行時的特性。 (第#1348號)

  • 修正了無法在 中使用非 ASCII 檔名的ResultFilePathDownloadStartingEventArgs錯誤。 (第#1428號)

  • 修正了預設彈出視窗標題欄沒有完全顯示的錯誤。 此變更是針對執行時的特性。 (第#1016期)

.NET

Bug 修正

  • 修正了 WebView2 .NET API 參考文件中只顯示第一個例外的問題。

  • .NET 核心函式庫現已以發佈模式建置。 除錯時，請確保你清除 「Just my code 」的勾選框。

  • 修正了一個導致 WebView2 在有子表單時當機的錯誤。 子表單在開啟頁面欄時，關閉子表單時會導致 WebView2 當機。 (第#1097號)

1.0.902.49

上映日期：2021年7月26日

NuGet package for WebView2 SDK 1.0.902.49

為完全 API 相容性，本版本 WebView2 SDK 需 WebView2 執行時版本 92.0.902.49 或更高版本。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

Bug 修正

  • 修正了一個破壞屬性的 IsBuiltInErrorPageEnabled 錯誤，該錯誤導致導航或渲染過程失敗時顯示的錯誤頁面關閉。 此變更是針對執行時的特性。 (第#634期)

  • 修正了 WebView2 控制項會讓使用者無法專注的問題。

  • 修正了子 AddScriptToExecuteOnDocumentCreated 視窗無法運作的錯誤。 (第#935期)

  • 修正了一個會導致非活躍分頁自動被丟棄的錯誤。 (第#637期)

  • 修正了一個錯誤，當一個導航事件被另一個導航事件中斷，導致事件的 NavigationCompleted 導航 ID 錯誤時。 (第#1142號)

1.0.902-預發布

上映日期：2021年6月1日

NuGet 套件用於 WebView2 SDK 1.0.902-prerelease（prerelease）

為了完整 API 相容性，此預發布版 WebView2 SDK 需要 Microsoft Edge 版本 92.0.902.0 或更高版本。

一般功能

  • WebView2 啟動效能與磁碟佔用量提升。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

Bug 修正

  • 修正滑鼠左鍵無法關閉右鍵選單的錯誤。 此變更是針對執行時的特性。

  • 修正了一個 WebView2 建立失敗的錯誤，當共用同一使用者資料資料夾的應用程式的執行檔版本資訊不一致時，會失敗。

  • 修正了一個錯誤，例如特殊瀏覽器按鍵 Refresh如 、 Home和 Back 無法被 AreBrowserAcceleratorKeysEnabled停用。 此變更是針對執行時的特性。

  • 修正了 WebView2 .NET 控制項中的一個錯誤，當 WebView2 在背景建立視窗時是空白的。 (第#1077期)

  • 按 Enter 或 Esc 鍵關閉檔案選擇器對話框，不再會讓使用 WebView2 控制的 WPF 應用程式當機。 (第#1099期)

  • 已修正一個錯誤，當事件處理器附加時， AllowSingleSignOnUsingOSPrimaryAccount 無法正常運作於 WebView2 WebResourceRequested 。 此變更是針對執行時的特性。 (第#1183期)

  • 下載檔案不再破壞 WebView2 DefaultBackgroundColor 的透明度。 此變更是針對執行時的特性。 (第#1108號)

  • 移除包含 Microsoft 品牌的螢幕分享媒體選擇訊息。 (第#940號)

  • 修正了 WebView2 WinForm 控制項中的一個錯誤，隱藏父表單並不會隱藏 WebView2 控制項。 (第#828期 與 第#1079期)

  • 為 WebView2 的 WPF 視窗新增靜態WS_CLIPCHILDREN樣式。 (第#1013期) 。

  • 修正了一個錯誤，就是右鍵點擊連結會讓 WebView2 主機應用程式當機。 此變更是針對執行時的特性。

  • 修正了一個可靠性錯誤，該錯誤在轉換到較新的 Edge WebView2 執行時可能導致主機應用程式程序當機。

  • 棄用：官方已 DefaultBackgroundColor 棄用 Windows 7 的 API。

.NET

Bug 修正

  • 已修正 WebView2 WinForm 控制中的一個錯誤，導致父視窗被丟棄後，WebView2 視窗的可見性未正確更新。 (第#1282期 與 第#828期)

  • 修正了 WebView2 WPF 控制中一個錯誤，導致 WPF OneWay 綁定模式中的來源屬性綁定無法正常運作。 (第619期 與 第#608期)

1.0.864.35

上映日期：2021年5月31日

NuGet package for WebView2 SDK 1.0.864.35

為了完整 API 相容性，本版本的 WebView2 SDK 需要 WebView2 執行時版本 91.0.864.35 或更高版本。

Bug 修正

  • 修正了一個可靠性錯誤，該錯誤在轉換到較新的 Edge WebView2 執行時可能導致主機應用程式程序當機。

  • 修正了一個在某些情況下無法清除記憶體的錯誤。 此變更是針對執行時的特性。

  • 修正了 818 SDK 發佈套件中專案找不到檔案的 WebView2.h 錯誤。 (第#1209期) 。

  • 修正了一個錯誤，導致部分帶有二進位主體的請求被丟棄 WebResourceRequested 事件。

  • 改善 NewWindowRequested 文件說明。 (第448期) 。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

.NET

Bug 修正
  • 修正了 WebView2 .NET 控制中一個錯誤，當重複 CoreWebView2WebResourceRequest 標頭集合時缺少第一個標頭。 (第#1123期) 。

1.0.865-預釋版本

上映日期：2021年4月26日

NuGet 套件 for WebView2 SDK 1.0.865-prerelease

為了完整 API 相容性，此 WebView2 SDK 預發布版本需要 Microsoft Edge 版本 91.0.865.0 或更高版本。

預發布 (中晉升為第一階段實驗)

以下實驗性 API 已在本預發布 SDK 中加入。

Bug 修正

  • WebView2 中包含二POST進位資料訊息的固定處理程序Chromium DevTools Protocol。

  • 關閉OpenSaveAsAwareness了下載介面，因為它包含了連結。edge://settings (第#1120期) 。

  • 移除螢幕分享對話框中的品牌標示。 (第#940號) 。

  • 修正了 SetWindowDisplayAffinity 函式在 WebView2 應用程式中停止螢幕擷取時導致 WebView2 壞掉的錯誤。 (第#841期) 。

  • 修正了構圖主機的錯誤，當任何筆輸入傳送到 WebView2 時，滑鼠輸入會停止運作。

  • 修正了滑鼠輸入在任何筆輸入後都會壞掉的錯誤。 此變更是針對執行時的特性。

.NET

預發布 (中晉升為第一階段實驗)

以下 .NET 的實驗性 API 已在本預發布 SDK 中加入。

  • 在 WPF 工具箱中新增了 WebView2 設計工具。 (第210期) 。

  • 在 .NET Designer 模式下新增了 WebView2 UI 元素。

Bug 修正

  • 透過將每個例外包裝成更詳細的 .NET 例外，改進了 COM 例外描述。 (第338期) 。 此變更是針對執行時的特性。

  • 已修正 Tab 鍵切換焦點時，導致 Microsoft Visual Studio Tools for Office 中 WebView2 控制當機的錯誤。 (期#589 與 期#933) 。 此變更是針對執行時的特性。

  • 改進了 .NET 框架下層載入器，使其更穩健。 (第946期)

  • 修正了當你在第一次導航完成前嘗試刷新時會當機的錯誤。 (第#1011期)

  • 固定初始化，因此導航會在 CoreWebView2InitializationCompleted期間進行。 (第#1050號)

  • 改進了 .NET 瀏覽器程序當機錯誤處理。 你現在可以在處理 ProcessFailed 事件後重新建立控制，且不會當機。 (第#996號)

1.0.818.41

發行日期：2021年4月21日

NuGet package for WebView2 SDK 1.0.818.41

為完整 API 相容性，此版本 WebView2 SDK 需 WebView2 執行時版本 90.0.818.41 或以上。

功能

  • 延長了 ProcessFailed 活動。 現在它會為非渲染器的子程序和框架渲染器進行檢舉。
  • 新增iframe元素支援。AddScriptToExecuteOnDocumentCreated
  • 改進 WebView2 程式碼，使其對格式錯誤的應用程式檔案更具韌 .exe 性。 (第#850期) 。
  • 已從 WebView2 瀏覽器的命令列中移除 --winhttp-proxy-resolver ，並開啟了 WebView2 的其他代理命令列選項。

1.0.824-預發布

發行日期：2021年3月8日

NuGet 套件 for WebView2 SDK 1.0.824-prerelease

為了完整 API 相容性，此預發布版本的 WebView2 SDK 需要 Microsoft Edge 版本 91.0.824.0 或更高版本。

功能

  • 延長了 ProcessFailed 活動。 現在它會為非渲染器的子程序和框架渲染器進行檢舉。
  • 新增了實驗性的 AreBrowserAcceleratorKeysEnabled 設定。 你可以阻止瀏覽器回應與導航、列印、儲存及其他瀏覽器專屬功能的鍵盤快捷鍵。
  • 新增iframe元素支援。AddScriptToExecuteOnDocumentCreated

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

Bug 修正

  • 擴充支援的 C++ 與 .NET 專案類型，如 MFC 與 ATL。 (期# 506、 期#669及 期#851) 。

  • 修正了 Evergreen WebView2 執行時洩漏 Inbound 防火牆條目的錯誤。

  • 事件期間 WebResourceRequested 的反應設定固定。 (第568期) 。

  • 修正了一個 Bug，就是在瀏覽到 edge:// 時瀏覽器程序會退出。 (第604期) 。

  • 修正了一個限制 WebView2 在視覺主機模式下螢幕大小限制的錯誤。

1.0.774.44

發行日期：2021年3月8日

NuGet package for WebView2 SDK 1.0.774.44

為完全相容 API，此版本 WebView2 SDK 需支援 WebView2 執行時版本 89.0.774.44 或更高版本。

功能

  • 在 WebView2 中關閉了各種 Microsoft Edge 瀏覽器服務。
  • 視覺化主機 API 現已公開使用。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

Bug 修正

  • 修正了一個限制 WebView2 在視覺主機模式下螢幕大小限制的錯誤。

1.0.790-預釋版本

發行日期：2021年2月10日

NuGet 套件用於 WebView2 SDK 1.0.790-prerelease

此 WebView2 SDK 預發布版本需 Microsoft Edge 版本 86.0.616.0 或更高。

重大變更

預發布套件 1.0.781 已被棄用

WebView2 預發布套件 1.0.781 已被棄用。 停止使用 1.0.781 套件的開發。

預發布套件 0.9.430 已被棄用

WebView2 預發布套件 0.9.430 已被棄用，並於下一版本中移除。 如果你的 WebView2 應用程式使用該套件，WebView2 團隊建議你轉換到更新的套件。

功能

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

Bug 修正

  • 在 WebView2 中關閉了 Microsoft Edge 購物功能。

  • 當 AreDefaultContextMenusEnabled 是 false時，我已經在 PDF 檢視器中關閉了右鍵選單。 (#605) 期。

  • 修正了查詢 時ICoreWebView2Experimental出現E_NOINTERFACEICoreWebView2的錯誤。 (第#691期) 。

  • 修正了一個錯誤，當 設定為 false時，URI CoreWebView2NavigationStartingEventArgs.Cancel 會被錯誤地帶入導航。 (第400期) 。

  • 修正了一個會阻 window.print() 擋事件 NewWindowRequested 處理程式彈出視窗的錯誤。 (第#409期) 。

  • 已修正在不同螢幕間移動應用程式時動態 DPI 問題。 (第58號)

  • 改進 HRESULT 了 ICoreWebView2WebResourceResponseViewGetContentCompletedHandler：：Invoke 傳遞的實例。

  • 關閉自動填充管理按鈕。 (第#585期) 。

  • 修正了 Visual Studio 在多個視窗中運行時會當 WebView2.Dispose 機的問題。 (第#816期) 及 第#442期) 。

  • 已修正 Visual Studio 工具箱中顯示 WebView2 控制項的錯誤。 (第210期) 。

  • 降低了高 CPU 使用率的問題。 (第#878期) 。

  • 已修正已棄用的 1.0.781 預發布套件的問題。 (期#875 與 #878) 。

.NET

Bug 修正

  • 已修正使用 WPF SDK 的 WebView2 應用程式當機的錯誤。 當按下 F4 關閉視窗時，當機發生。 (第#399期) 。

  • WebView2 初始化畫面現在是透明的，而非灰色。 (第#196期) 。

1.0.705.50

發行日期：2021年1月25日

NuGet 套件 for WebView2 SDK 1.0.705.50

此版本的 WebView2 SDK 需要 WebView2 執行時版本 86.0.616.0 或以上。

第三階段 (穩定版)

以下 API 已從第二階段：預發布穩定升級為第三階段：穩定發布，並包含在本版本 SDK 中。

1.0.721-預釋版本

發行日期：2020年12月8日

NuGet 套件用於 WebView2 SDK 1.0.721-prerelease（prerelease）

此 WebView2 SDK 預發布版本需 Microsoft Edge 版本 86.0.616.0 或更高。

重大變更

重要事項

重大變更：WebView2 預發布套件 1.0.707 與套件 0.9.628 已被棄用。 停止使用套件 1.0.707 與 package0.9.628 的開發。

功能

  • 新增 WebView2 群組政策。 最佳實務請參閱 WebView2 的群組政策。

  • 重要事項

    變革：已棄用舊的登錄地點。

    {Root}\Software\Policies\Microsoft\EmbeddedBrowserWebView\LoaderOverride\{AppId}

  • 新增對 WebView2 拖 放 功能的支援。

  • 新增了 API 來處理 DPI 支援。

    • 新增了 RasterizationScale 屬性，以改變 WebView2 內容和 UI 彈出視窗的 DPI 比例，以及相關的 RasterizationScaleChanged 事件。
    • 新增了 ShouldDetectMonitorScaleChanges 屬性，以自動更新 RasterizationScale 屬性（如有需要）。
    • 新增 了 BoundsMode 屬性 ，指定界限為邏輯像素，並允許 WebView2 用於 RasterizationScale WebView2 的像素顯示，而 WebView2 則使用 與 RasterizationScale 的 Bounds 來取得實體尺寸。

  • 更新 NewWindowRequested 事件以處理 Ctrl+click 和 Shift+click 。 (期# 168 與 期#371) 。

預發行 (階段穩定版的推廣)

以下 API 已從第一階段：預發布的實驗階段升級為第二階段：預發布的穩定階段，並包含在本預發布 SDK 中。

.NET

功能
Bug 修正

1.0.664.37

發行日期：2020年11月20日

NuGet 套件 for WebView2 SDK 1.0.664.37

此版本的 WebView2 SDK 需要 WebView2 執行時版本 86.0.616.0 或以上。

正式發行

重要事項

公告：.NET WPF/WinForms WebView2 SDK 現已 (GA) 正式開放。 從本版本開始，版本 SDK 具備向前相容性。 更多細節請參閱 GA公告部落格文章。

功能

  • .NET WPF/WinForms WebView2 現已 (通用版) 正式提供。
  • 固定發行 (自帶) 模式已達一般公開。

.NET

Bug 修正
  • CoreWebView2NewWindowRequestedEventArgs.Handled 阻止新視窗被打開。 (第549期 與 第#560期) 。

1.0.674-預釋版本

上映日期：2020年10月19日

NuGet 套件 for WebView2 SDK 1.0.674-prerelease

此預發布版本的 WebView2 SDK 需要 WebView2 執行時版本 86.0.616.0 或以上。

一般功能

.NET

1.0.622.22

上映日期：2020年10月19日

NuGet 套件 for WebView2 SDK 1.0.622.22

此版本的 WebView2 SDK 需要 WebView2 執行時版本 86.0.616.0 或以上。

重要事項

公告：Win32 C/C++ WebView2 現已正式 (通用) 上架。 從本版本開始，版本 SDK 具備向前相容性。 詳見 GA公告部落格文章。

  • Evergreen WebView2 執行環境和安裝程式都是通用軟體。 Evergreen WebView2 執行時的 bootstrapper、下行連結，以及 Evergreen WebView2 執行時的獨立安裝程式，皆可在 Microsoft Edge WebView2 上取得。 安裝工作流程的範例程式碼也可在 WebView2Samples 倉庫中取得。

欲了解更多關於執行環境、常青發行版及固定版本發行的資訊，請參閱 「分發您的應用程式」及「WebView2 執行時」。

0.9.622.11

發行日期：2020年9月10日

NuGet package for WebView2 SDK 0.9.622.11

此版本的 WebView2 SDK 需要 WebView2 執行時版本 86.0.616.0 或以上。

0.9.579

發行日期：2020年7月20日

NuGet package for WebView2 SDK 0.9.579

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 86.0.579.0 或更高版本。

所有月台

  • 重要事項

    公告：Evergreen WebView2 執行時及安裝程式已釋出預覽版。 請參閱 「分發你的應用程式」和 WebView2 執行時。

  • 重要事項

    公告：以下 WebView2 SDK 版本在下一次 SDK 發布後將不再支援：

    WebView2 SDK 版本在 nuget.org 上也被標記為棄用。WebView2 建議持續更新最新版本的 WebView2。

  • 新增了 WebView2 工作者執行緒的改進。 (#318) 期。

  • 在 WebView2 裡關閉了彈出視窗阻擋器。 請參考事件NewWindowRequested中的 IsUserInitiated 屬性。

  • 確保 WebView2 導航啟動事件執行。about:blank 現在， NavigationStarting 所有導航都會舉辦活動，但 about:blanksrcdociframe 取消或取消元素的活動則不被支持且被忽略。

  • 在 WebView2 中封鎖了一些 edge:// URI 方案。

  • 在 WebView2 環境中新增了實驗性的 IsSingleSignOnUsingOSPrimaryAccountEnabled 屬性選項，以開啟 WebView2 的條件存取。

  • 新增了實驗性的 WebResourceResponseReceived 事件，該事件會在 WebView2 接收並處理 WebResource 請求的回應後執行。 認證標頭（如有）會包含在回應物件中。

.NET

  • WPF 對焦處理更佳。 (第#185期) 。
  • 新增 ZoomFactor 了 WPF Webview2 控制器上的屬性。

0.9.538

發行日期：2020年6月8日

NuGet package for WebView2 SDK 0.9.538

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 85.0.538.0 或更高版本。

所有月台

  • 停止支援 WebView2 SDK 版本 0.8.149。 WebView2 建議持續更新最新版本的 WebView2。
  • 更新群組政策以考慮當 Microsoft Edge 瀏覽器的設定路徑被修改 (#179) 。

Win32 C/C++

.NET (0.9.538 預發布版)

0.9.515-預釋

上映日期：2020年5月14日

NuGet 套件for WebView2 SDK 0.9.515-prerelease

此 WebView2 SDK 預發布版本需 Microsoft Edge 版本 84.0.515.0 或更高版本。

  • 重要事項

    公告：WebView2 現已支援 .NET Framework 4.6.2 或更新版本的 Windows Forms 與 WPF，以及預發佈套件中的 .NET Core 3.0 或更新版本。

  • 欲了解更多關於建置 WPF 應用程式的資訊，請參閱「 在 WPF 應用程式中開始使用 WebView2 」及 WebView2 WPF 專用 API 參考。

  • 欲了解更多關於建置 Windows Forms 應用程式的資訊，請參閱《WinForms 應用程式中的 Web View2 開始使用》及 Windows Forms 專用 API 的 WebView2 Windows Forms 參考資料。

  • 欲了解更多 CoreWebView2 API 的資訊，請參閱 .NET 參考文獻。

  • 注意

    已知問題：WebView2 團隊已知預發布時存在一些問題，未來版本正逐步修正。

    • DPI 感知：WPF 的 WebView2 目前尚未具備 DPI 感知功能。 在高 DPI 螢幕上初始化 WebView2 時，有一個已知問題，就是 WebView2 控制器一開始會以視窗的一部分初始化，直到視窗被調整尺寸。
    • WPF Designer：目前不支援 WPF 設計器。 透過文字編輯器直接修改相應的 XAML 來新增 WebView2 控制項。

0.9.488

發行日期：2020年4月20日

NuGet 套件 for WebView2 SDK 0.9.488

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 84.0.488.0 或以上。

0.9.430

發行日期：2020年2月24日

NuGet 套件 for WebView2 SDK 0.9.430

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 82.0.430.0 或更高版本。

WebView2 SDK 是官方的 Win32 C++ Beta 版本，包含多項來自回饋的功能需求。 WebView2 團隊嘗試限制有破壞性變更的釋出次數。 隨著全面開放，Beta 版本中加入了多項重大重大變更。

  • 重要事項

    重大變革：隨著最終版本接近，WebView2 團隊將前綴 IWebView2WebView 重新命名為 ， ICoreWebView2 以確保 WebView2 API 與 Windows API 命名慣例一致。 此外，為了利用 UI 框架中的 WebView2 SDK，WebView2 團隊將 ICoreWebView2ICoreWebView2 與 ICoreWebView2Host 分拆出來。 ICoreWebView2Host 支援調整大小、顯示與隱藏、對焦及其他與視窗與構圖相關的功能。 ICoreWebView2 支援所有其他 WebView2 功能。 欲了解更多如何整合這些變更，請參閱 WebView2 APISample 專案中的 WebView2 拉取請求。

  • 重要事項

    破壞性變更：將 DocumentStateChanged 拆分成三個元件： SourceChanged、 ContentLoading 和 HistoryChanged。 現在，當來源網址改變 SourceChanged 時，事件就會被執行。 當歷史狀態改變時， HistoryChanged 該事件會被執行。 當新文件載入時，該 ContentLoading 事件會在初始腳本之前執行。

  • 新增對 ARM64 架構的支援。

  • 新增軟輸入面板 (SIP) 觸控螢幕裝置支援。

  • 新增支援 Windows Server 2008 R2、Windows Server 2012、Windows Server 2012 R2 及 Windows Server 2016。

  • 新增 了 NotifyParentWindowPositionChanged 功能，讓狀態列在視窗模式下跟隨視窗。 同時，也要實作無視窗模式的變更，讓無障礙功能正常運作。

  • 新增 AreRemoteObjectsAllowed 設定，以全域控制網頁是否能被任何遠端物件存取。 預設情況下， AreRemoteObjectsAllowed 是開啟的，因此由 AddRemoteObject 新增的遠端物件可從網頁存取。 關閉後 AreRemoteObjectsAllowed ，這些物件無法從網頁存取。 變更會在下一次導航事件中套用。

  • 新增 IsZoomControlEnabled 設定，防止使用者使用 Ctrl++ 與 Ctrl+- (或 Ctrl+ 滑鼠滾輪) 影響 WebView2 控制項的縮放。 即使關閉縮放，仍可用 put_ZoomFactor 設定。

  • 將 ZoomFactor 改為只適用於目前的 WebView2 控制項。 目前 WebView2 控制項的縮放變更不會影響你用同一原始網站導航到的其他 WebView。 請看 get_ZoomFactor。

  • 隱藏 WebView2 控制的 ZoomView UI， (#95) 。

  • 新增 了 SetBoundsAndZoomFactor。 現在，你可以同時設定 WebView2 控制項的縮放因子和範圍。

  • 新增了 WindowCloseRequested 事件。 請參見 add_WindowCloseRequested (#119) 。

  • 新增對 JavaScript 對話事件對話 beforeunload 類型功能的支援，並新增 了列舉CORE_WEBVIEW2_SCRIPT_DIALOG_KIND_BEFOREUNLOAD 項目。

  • 新增 GetHeaders 到 HttpRequestHeaders，GetHeader 加入 HttpResponseHeaders，並將 get_HasCurrentHeader 屬性加入 HttpHeadersCollectionIterator。

  • 重要事項

    破壞性改變：行為被修改 DevToolsProtocolEventReceived 。 現在，你可以為特定的 DevTools 協議事件建立 DevToolsProtocolEventReceiver ，並使用 add_DevToolsProtocolEventReceived/remove_DevToolsProtocolEventReceived 訂閱或取消訂閱該事件。

  • 重要事項

    破壞性變更：將get_WebMessageAsString屬性改WebMessageReceivedEventArgs為 TryGetWebMessageAsString 方法。

  • 重要事項

    破壞性變更：將 Handle 方法改AcceleratorKeyPressedEventArgs為 get_Handled 屬性。

0.8.355

發行日期：2019年12月9日

NuGet package for WebView2 SDK 0.8.355

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 80.0.355.0 或更高版本。

  • 發布了 WebView2API 範例，這是 WebView2 SDK 的完整指南。 請參閱 API 範例。
  • 新增了除英語外所有語言的 IME 支援 (#30) 。
  • 針對錯誤回報更新了事件的 WebResourceRequested API 表面。 同時指定過濾器與建立事件的做法現在被棄用。 要建立網路資源請求事件，請使用 add_WebResourceRequested 來新增事件，使用 AddWebResourceRequestedFilter 來新增過濾器。 RemoveWebResourceRequestedFilter 移除了 #36) (#74) (的過濾器。

  • 重要事項

    突破性變更：修改過的全螢幕行為。 已棄用 isFullScreenAllowed。 現在，預設情況下，如果 WebView2 控制項 (中的某個元素（例如影片) 設為全螢幕），它就會填滿 WebView2 控制項的範圍。 使用 ContainsFullScreenElementChanged 事件並 get_ContainsFullScreenElement 指定應用程式在元素想進入全螢幕模式時，如何調整 WebView2 控制項大小。

0.8.314

發行日期：2019年10月28日

NuGet 套件 for WebView2 SDK 0.8.314

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 80.0.314.0 或以上。

變更

  • 新增對 Windows 7、Windows 8 及 Windows 8.1 的支援。 請參閱 Microsoft Edge WebView2 導論中的支援 Windows 版本。

  • 新增 Visual Studio 與 Visual Studio Code 除錯支援 WebView2。 現在，直接從你的 IDE 到 WebView2 除錯你的腳本。 請參閱 如何使用 WebView2 控制項開發除錯。

  • 新增 Native Object Injection 於 WebView2 中執行中的腳本，從應用程式的 Win32 元件存取 IDispatch 物件，並取得該物件的屬性。 參見 AddRemoteObject (#17) 。

  • 新增 AcceleratorKeyPressed 事件。 詳見 add_AcceleratorKeyPressed (#57) 。

  • 關閉了 Context Menus. 詳見 put_AreDefaultContextMenusEnabled (#57) 。

  • 更新。DPI Awareness 現在，WebView2 控制項的 DPI 感知與主機應用程式的 DPI 感知相同。

    注意事項

    如果另一個混合應用程式啟動時，DPI 感知與原本 WebView2 控制實例不同，則新的 WebView2 控制實例不會啟動，且該 user data folder 實例是相同的 (#1) 。

  • 更新 Notification Change Behavior 後，WebView2 會自動拒絕因 WebView2 控制項中託管的網頁內容所觸發的通知權限請求。

0.8.270

發行日期：2019 年 9 月 10 日

NuGet 套件 for WebView2 SDK 0.8.270

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 78.0.270.0 或以上。

變更

  • 新增 DocumentTitleChanged 事件以指示文件標題變更 (第 27期) 。

  • 新增 GetWebView2BrowserVersionInfo API (#18) 。

  • 新增 NewWindowRequested 事件。

  • 更新 CreateWebView2EnvironmentWithDetails 函數以移除 releaseChannelPreference。 欲了解更多函式資訊 CreateWebView2EnvironmentWithDetails ，請參閱 CreateWebView2EnvironmentWithDetails。 登錄檔和環境變數覆寫功能仍然被支援。 除非被覆蓋，否則會使用預設頻道偏好。

    在頻道搜尋過程中，WebView2 團隊會跳過任何與 WebView2 SDK 不相容的先前頻道版本。

    WebView2 團隊會選擇較穩定的通道，以確保最終使用者的行為最一致。 當你用最新的 Canary 版本測試時，應該先建立一個腳本，在啟動應用程式前設定WEBVIEW2_RELEASE_CHANNEL_PREFERENCE環境變數。1 請參閱 測試即將推出的 API 與功能。

  • 更新 CreateWebView2EnvironmentWithDetails 了函式，加入了在未指定時選擇 userDataFolder 的邏輯。 欲了解更多函式資訊 CreateWebView2EnvironmentWithDetails ，請參閱 CreateWebView2EnvironmentWithDetails。 如果你之前用的是預設 userDataFolder 位置，當你切換到新 SDK 時，預設 userDataFolder 值會被重置 (在主機程式碼目錄) 中設定為新位置，且你的狀態也會被重置。 如果主機程序沒有寫入指定目錄的權限，函 CreateWebView2EnvironmentWithDetails 式可能會失敗。 你可以把舊 user data folder 目錄的資料複製到新目錄。

0.8.230

上映日期：2019年7月29日

NuGet package for WebView2 SDK 0.8.230

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 77.0.230.0 或更高版本。

變更

  • 新增 Stop API，以停止所有導航及待處理的資源擷取 (第 #28) 。
  • 在第 #22 期) 新增.tlb檔案 (NuGet 套件。
  • 在 Issue #32) (在 NuGet 套件中新增了 .NET 專案。

0.8.190

發行日期：2019年6月17日

NuGet 套件 for WebView2 SDK 0.8.190

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 77.0.190.0 或更高版本。

  • 新增 get_AreDevToolsEnabled/put_AreDevToolsEnabled 以控制使用者是否能開啟 DevTools (#16) 。
  • 新增 get_IsStatusBarEnabled/put_IsStatusBarEnabled 控制狀態列是否顯示 (問題#19) 。
  • 新增get_CanGoBackget_CanGoForwardGoForward/GoBack//功能用於瀏覽導航歷史。
  • 新增 HTTP 標頭類型 (IWebView2HttpHeadersCollectionIterator//IWebView2HttpRequestHeadersIWebView2HttpRequestHeaders) 用於檢視及修改 WebView2 中的 HTTP 標頭。
  • 在第 #13) 期 (新增 32 位元 WebView2 支援 64 位元機器。
  • 在 SDK (第 #14) 新增了 WebView2 IDL。
  • 新增函式庫以支援 IID\_\*Issue #12 () 。
  • 新增了 DLL 檔案的路徑、連結，以及自動複製到 SDK 中的 NuGet TARGET 檔案。
  • 在腳本裡開啟請求 window.open() 功能。

0.8.149

上映日期：2019年5月6日

NuGet package for WebView2 SDK 0.8.149

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 76.0.149.0 或以上。

初步開發者預覽版。

另請參閱

  • Last updated on