通过

WebView2 SDK 发行说明

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

1.0.3351.48

发布日期：2025 年 7 月 1 日

用于 WebView2 SDK 1.0.3351.48 的 NuGet 包

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

促销

以下 API 已从阶段 2：在预发行版中稳定升级为阶段 3：在发布中稳定，现在已包含在此发布 SDK 中。

允许输入事件消息通过浏览器窗口传递

类 CoreWebView2ControllerOptions 现在具有一个 AllowHostInputProcessing 属性，它允许用户输入事件消息 (键盘、鼠标、触摸或笔) 通过浏览器窗口，由应用进程窗口接收。

Bug 修复

仅限运行时
  • 修复了视觉对象托管中对话框的黑盒问题。

1.0.3296.44

发布日期：2025 年 6 月 3 日

用于 WebView2 SDK 1.0.3296.44 的 NuGet 包

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

促销

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

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

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

Bug 修复

仅限运行时
  • 修复了打印的 PDF 中的边距。

1.0.3344-prerelease

发布日期：2025 年 6 月 3 日

用于 WebView2 SDK 1.0.3344-prerelease 的 NuGet 包

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

实验性 API

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

促销

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

允许输入事件消息通过浏览器窗口传递

类 CoreWebView2ControllerOptions 现在具有一个 AllowHostInputProcessing 属性，它允许用户输入事件消息 (键盘、鼠标、触摸或笔) 通过浏览器窗口，由应用进程窗口接收。

Bug 修复

仅限运行时
  • 修复了触摸事件后鼠标事件不触发的 bug。
  • 在 WebView2 控件上禁用了 Web 捕获。
  • 修复了 “下载 ”对话框。
  • 修复了默认浏览器帧中下载的问题。 (问题 #5196)
  • 修复了打印的 PDF 中的边距。

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时可能发生的崩溃。

另请参阅

API 参考：