通过

WebView2 SDK 发行说明

  • 项目

这些发行说明提供有关 WebView2 发布 SDK 和 WebView2 预发布 SDK 中包含的新功能和 bug 修复的信息。

1.0.3240.44

发布日期：2025 年 5 月 5 日

用于 WebView2 SDK 1.0.3240.44 的 NuGet 包

为了完全实现 API 兼容性，此 WebView2 SDK 版本需要 WebView2 运行时版本 136.0.3240.44 或更高版本。

促销

以下 API 已提升为稳定版，现已包含在此发布 SDK 中。

跟踪嵌套 iframe 的导航历史记录 (FrameCreatedEvent API)

FrameCreatedEvent API 支持嵌套 iframe，例如记录二级 iframe 的导航历史记录。 如果没有此 API，WebView2 仅跟踪第一级 iframe，它们是main帧的直接子 iframe。 使用此 API，应用可以订阅嵌套 iframe 创建事件，使应用能够访问嵌套 iframe 的所有属性、方法和事件 CoreWebView2Frame 。

使用此 API 在包含多个级别的 iframe 的页面上管理 iframe 跟踪。 可以选择跟踪以下任一项：

  • 只有main页和一级 iframe (默认行为) 。
  • 部分 WebView2 框架树，其中包含感兴趣的特定 iframe。
  • 完整的 WebView2 框架树。

Bug 修复

仅限运行时
  • 修复了从默认浏览器帧内下载未完成的问题。 (问题 #5196)
  • 修复了错误地返回管道名称，导致某些 UWP 应用崩溃的问题。

1.0.3296-prerelease

发布日期：2025 年 5 月 12 日

用于 WebView2 SDK 1.0.3296-prerelease 的 NuGet 包

为了完全实现 API 兼容性，此预发布版本的 WebView2 SDK 需要Microsoft Edge 版本 137.0.3296.0 或更高版本随附的 WebView2 运行时。

实验性 API

此预发布 SDK 中未添加任何实验性 API。

促销

在此预发行版 SDK 中，以下 API 已从实验性提升为稳定 API。

在 WebView2 初始化 (DefaultBackgroundColor API) 上设置默认背景色

DefaultBackgroundColor API 允许用户在初始化时设置 DefaultBackgroundColor 属性。 这可以防止在 WebView2 加载过程中出现中断性白闪烁。

Bug 修复

仅限运行时
  • 修复了“ 查找 栏”在窗口移动后不再显示问题。
  • 修复了应用无法通过事件取消导航到登录页的 NavigationStarting bug。
  • 修复了从默认浏览器帧内下载未完成的问题。 (问题 #5196)
  • 修复了错误地返回管道名称，导致某些 UWP 应用崩溃的问题。

1.0.3179.45

发布日期：2025 年 4 月 7 日

用于 WebView2 SDK 1.0.3179.45 的 NuGet 包

为了完全实现 API 兼容性，此 WebView2 SDK 版本需要 WebView2 运行时版本 135.0.3179.45 或更高版本。

促销

此发布 SDK 中没有其他 API 已提升到稳定版并已添加。

Bug 修复

仅限运行时
  • 修复了 HTML Select 元素 (<选择>) ，使其可在 WPF 应用中选择。
  • 修复了在 WebView2 控件中导航 的问题 edge://crashes 。
  • 修复了从 WebView2 实例调用 Windows 凭据 UI 时潜在的崩溃和 UI 问题。
  • 修复了用户无法使用自动填充信息键入输入字段的 bug。 (问题 #5144)

1.0.3230-prerelease

发布日期：2025 年 4 月 7 日

用于 WebView2 SDK 1.0.3230-prerelease 的 NuGet 包

为了完全实现 API 兼容性，此预发布版本的 WebView2 SDK 需要Microsoft Edge 版本 136.0.3230.0 或更高版本随附的 WebView2 运行时。

实验性 API

此预发布 SDK 中未添加任何实验性 API。

促销

在此预发行版 SDK 中，以下 API 已从实验性提升为稳定 API。

跟踪嵌套 iframe 的导航历史记录 (FrameCreatedEvent API)

FrameCreatedEvent API 支持嵌套 iframe，例如记录二级 iframe 的导航历史记录。 如果没有此 API，WebView2 仅跟踪第一级 iframe，它们是main帧的直接子 iframe。 使用此 API，应用可以订阅嵌套 iframe 创建事件，使应用能够访问嵌套 iframe 的所有属性、方法和事件 CoreWebView2Frame 。

使用此 API 在包含多个级别的 iframe 的页面上管理 iframe 跟踪。 可以选择跟踪以下任一项：

  • 只有main页和一级 iframe (默认行为) 。
  • 部分 WebView2 框架树，其中包含感兴趣的特定 iframe。
  • 完整的 WebView2 框架树。

Bug 修复

仅限运行时
  • 修复了 WPF <中当鼠标移出 WebView2 控件边界时数据列表> 下拉列表关闭的问题。
  • 修复了在 WebView2 控件中导航 的问题 edge://crashes 。
  • 修复了 HTML Select 元素 (<选择>) ，使其可在 WPF 应用中选择。
  • 修复了从 WebView2 实例调用 Windows 凭据 UI 时潜在的崩溃和 UI 问题。
  • 修复了用户无法使用自动填充信息键入输入字段的 bug。 (问题 #5144)
  • 修复了 状态栏 API 中的回归。
仅 SDK
  • 修复了窗口到视觉对象托管模式中的 Tab 键、 Shift+Tab 键和 箭头 键。

1.0.3124.44

发布日期：2025 年 3 月 10 日

用于 WebView2 SDK 1.0.3124.44 的 NuGet 包

为了完全实现 API 兼容性，此发布版本的 WebView2 SDK 需要 WebView2 运行时版本 134.0.3124.44 或更高版本。

促销

此发布 SDK 中没有其他 API 已提升到稳定版并已添加。

Bug 修复

仅限运行时
  • 无论开发人员模式是否处于打开状态，都不会通过使用 AddBrowserExtensionAsync在 WebView2 中禁用扩展。 (问题 #5113)
  • 禁用了网络时间的后台更新。 (问题 #5047)
  • 修复了在 时 target="_blank"不显示下载弹出窗口。 (问题 #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 从实验版提升为稳定版。

Bug 修复

运行时和 SDK
  • 修复了主机对象异步方法异常处理。 (问题 #3402)
  • 修复了 的文档 CoreWebVIew2.Navigate。 (问题 #5091)
仅限运行时
  • 修复了“添加到 Chrome”存储安装回归。
  • 修复了 UWP 和 WinUI 中的文件夹上传。 (问题 #3275)
  • 无论开发人员模式是否处于打开状态，都不会通过使用 AddBrowserExtensionAsync在 WebView2 中禁用扩展。 (问题 #5113)
  • 禁用了网络时间的后台更新。 (问题 #5047)
  • 修复了在 时 target="_blank"不显示下载弹出窗口。 (问题 #5063)
仅 SDK
  • 修复了当垃圾回收器在main线程以外的线程上调用Finalize时可能发生的崩溃。

1.0.3065.39

发布日期：2025 年 2 月 10 日

用于 WebView2 SDK 1.0.3065.39 的 NuGet 包

为了完全实现 API 兼容性，此 WebView2 SDK 版本需要 WebView2 运行时版本 133.0.3065.39 或更高版本。

促销

此发布 SDK 中没有其他 API 已提升到稳定版并已添加。

Bug 修复

仅限运行时
  • 在“下载”浮出控件中添加了缺少的“关闭”按钮。
  • 修复了从不发生 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 从实验版提升为稳定版。

Bug 修复

仅限运行时
  • 在“下载”浮出控件中添加了缺少的“关闭”按钮。
  • 修复了从不发生 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 运行时版本 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) ，例如在 的 中TabItemTabControl初始化时，它不会显示。 (问题 #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 允许以编程方式控制 Find 作，并允许将以下功能添加到应用：

  • 自定义“查找”选项，包括“查找术语”、“区分大小写”、“Word匹配”、“匹配突出显示”和“默认 UI 抑制”。
  • 查找文本字符串并在 WebView2 控件中导航。
  • 以编程方式启动 “查找 ”作，并在 “查找结果”中 导航。
  • 取消默认的 “查找 UI”。
  • 跟踪 “查找 ”作的状态。

查找 PDF 文档的 API 存在已知问题。 在 WebView2 控件中查看 PDF 文档时， “查找” 功能当前仅提供第一个索引和找到的匹配项数。 例如，如果字符串在 PDF 中出现三次，则 UI 将显示 1/3 ，并且不支持以编程方式调用 Next 或 Previous。 我们正在积极调查这些问题，我们鼓励你使用 WebView2Feedback 存储库报告遇到的任何问题。

自定义拖放行为 (DragStarting API)

在可视化托管模式下运行时，API DragStarting 会替代默认的拖放行为。 当用户在 WebView2 中启动拖动作时，事件 DragStarting 会通知应用，并提供使用自己的逻辑替代默认 WebView2 拖动作所需的状态。

  • 在 上ICoreWebView2ExperimentalCompositionController6使用 DragStarting 添加在拖动作启动时调用的事件处理程序。
  • 使用 ICoreWebView2ExperimentalDragStartingEventArgs 启动自己的拖动作。
    • GetDeferral使用 方法可执行任何异步拖动逻辑，并在以后重新调用 WebView。
    • Handled使用 属性让 WebView2 知道是否使用自己的拖动逻辑。
跟踪嵌套 iframe 的导航历史记录 (FrameCreatedEvent API)

FrameCreatedEvent API 支持嵌套 iframe，例如记录二级 iframe 的导航历史记录。 如果没有此 API，WebView2 仅跟踪第一级 iframe，它们是main帧的直接子 iframe。 使用此 API，应用可以订阅嵌套 iframe 创建事件，使应用能够访问嵌套 iframe 的所有属性、方法和事件 CoreWebView2Frame 。

使用此 API 在包含多个级别的 iframe 的页面上管理 iframe 跟踪。 可以选择跟踪以下任一项：

  • 只有main页和一级 iframe (默认行为) 。
  • 部分 WebView2 框架树，其中包含感兴趣的特定 iframe。
  • 完整的 WebView2 框架树。
在 WebView2 初始化 (DefaultBackgroundColor API) 上设置默认背景色

DefaultBackgroundColor API 允许用户在初始化时设置 DefaultBackgroundColor 属性。 这可以防止在 WebView2 加载过程中出现中断性白闪烁。

促销

在此预发行版 SDK 中，以下 API 已从实验性提升为稳定 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 控件始终显示在顶部，将任何 WPF 元素隐藏在同一位置，即使尝试使用可视化树顺序或 z-index 属性将 WPF 元素指定为 WebView2 控件上方 (， 例如) 。

出现此问题的原因是 WPF 控件使用 WPF HwndHost 托管 Win32 WebView2 控件，并且 HwndHost 存在空域问题。

另请参阅：

Bug 修复

仅限运行时
  • 修复了显示更改可能导致 WebView2 呈现小于应用窗口的回归。
  • 已启用 IsolateSandboxedIframes WebView2 的上游功能。
  • 在版本更改时阻止删除服务辅助角色。
  • 中的 CleanUpSome API Hostobject 现在仅对完整堆执行垃圾回收。 CleanUpSome 已从 V8 引擎中删除。
  • 修复了 的 AreBrowserAcceleratorKeysEnabled回归。 (问题 #5033)
  • 修复了使用键盘关闭对话框时未触发的 bug IsDefaultDownloadDialogOpenChanged 。 (问题 #4807)
仅 SDK
  • 修复了 WPF WebView2CompositionControl 中的问题：如果初始化时的大小 (0,0) ，例如在 的 中TabItemTabControl初始化时，它不会显示。 (问题 #4941)

另请参阅