通过

WebView2 SDK 发行说明

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

1.0.3650.58

发布日期：2025 年 12 月 8 日

用于 WebView2 SDK 1.0.3650.58 的 NuGet 包

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

升级到第 3 阶段 (在发布) 中稳定

在此发布 SDK 中，没有其他 API 从阶段 2：在预发行版中稳定升级到第 3 阶段：稳定发布。

Bug 修复

仅限运行时
  • 修复了触发权限警报弹出窗口的本地网络访问问题。

1.0.3712-prerelease

发布日期：2025 年 12 月 8 日

用于 WebView2 SDK 1.0.3712-prerelease 的 NuGet 包

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

升级到预发行版) 中的第 1 阶段 (实验

以下 API 处于第 1 阶段：预发行版中的实验性，并已添加到此预发行版 SDK 中。

自定义端口范围行为

允许的端口范围 API 可以限制或自定义 WebView2 可用于各种传输协议和范围的网络端口范围。 这提供了增强的安全控制。

  • SetAllowedPortRange在 CoreWebView2EnvironmentOptions (或 ICoreWebView2ExperimentalEnvironmentOptions) 实例上使用 以在创建环境期间配置端口限制。

    • scope使用 参数指定配置是应用于) (Default 所有组件，还是仅适用于 WebRTC 对等连接 (WebRtc) 。 目前仅 WebRtc 支持。

    • protocol使用 参数指定传输协议 (当前支持 Udp) 。

    • 指定 minPort 介于 1025-65535 (（含) ）之间的 和 maxPort 值，或使用 (0,0) 重置/删除限制。

  • 在 GetEffectiveAllowedPortRangeCoreWebView2EnvironmentOptions (或 ICoreWebView2ExperimentalEnvironmentOptions) 实例上使用 检索特定范围和协议的活动端口范围配置。

    • 返回给定范围的显式设置范围，如果未设置，则从 Default 范围继承。

    • 如果未为指定范围配置限制，则返回 (0,0) 。

升级到第 2 阶段 (预发行版中的稳定)

以下 API 已从阶段 1：预发行版中的实验性升级到阶段 2：预发行版中的稳定版，并包含在此预发行版 SDK 中。

自定义拖放行为 (DragStarting API)

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

  • 在 上ICoreWebView2CompositionController5使用 DragStarting 添加在拖动作启动时调用的事件处理程序。
  • 使用 ICoreWebView2DragStartingEventArgs 启动自己的拖动作。
    • GetDeferral使用 方法可执行任何异步拖动逻辑，并在以后重新调用 WebView。
    • Handled使用 属性让 WebView2 知道是否使用自己的拖动逻辑。

Bug 修复

此预发布 SDK 包含以下 bug 修复。

仅限运行时
  • 修复了触发权限警报弹出窗口的本地网络访问问题。
  • 修复了 API 的 setColorScheme 回归。
  • 修复了命令行开关 enable-new-window-requested-deferred-initialization的延迟初始化ICoreWebView2NewWindowRequestedEventArgs。

1.0.3595.46

发布日期：2025 年 11 月 3 日

用于 WebView2 SDK 1.0.3595.46 的 NuGet 包

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

升级到第 3 阶段 (在发布) 中稳定

在此发布 SDK 中，没有其他 API 从阶段 2：在预发行版中稳定升级到第 3 阶段：稳定发布。

Bug 修复

此发布 SDK 包含以下 bug 修复。

仅限运行时
  • 禁用了创建“推理呈现器”进程。

1.0.3650-prerelease

发布日期：2025 年 11 月 7 日

用于 WebView2 SDK 1.0.3650-prerelease 的 NuGet 包

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

升级到预发行版) 中的第 1 阶段 (实验

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

升级到第 2 阶段 (预发行版中的稳定)

在此预发布 SDK 中，没有 API 从第 1 阶段：预发行版中的实验性升级到第 2 阶段：在预发布中稳定。

Bug 修复

此预发布 SDK 包含以下 bug 修复。

仅限运行时
  • 禁用了创建“推理呈现器”进程。
  • 修复了以编程方式执行 Find 时查找对话框同步的问题。

1.0.3537.50

发布日期：2025 年 10 月 6 日

用于 WebView2 SDK 1.0.3537.50 的 NuGet 包

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

升级到第 3 阶段 (在发布) 中稳定

在此发布 SDK 中，没有其他 API 从阶段 2：在预发行版中稳定升级到第 3 阶段：稳定发布。

Bug 修复

此发布 SDK 包含以下 bug 修复。

仅限运行时
  • 修复了触发权限警报弹出窗口的本地网络访问问题。
仅 SDK
  • 修复了 的 WebView2Loader.dllBinSkim 错误。

1.0.3590-prerelease

发布日期：2025 年 10 月 7 日

用于 WebView2 SDK 1.0.3590-prerelease 的 NuGet 包

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

升级到预发行版) 中的第 1 阶段 (实验

以下 API 处于第 1 阶段：预发行版中的实验性，并已添加到此预发行版 SDK 中。

敏感度标签支持

WebView2 中新的敏感度信息 API 使应用程序能够通过 页面交互限制管理器访问网页传达的敏感度标签信息。 此功能可帮助主机应用程序检测和响应敏感内容。

主要功能：

  • 配置页面交互限制管理器可用性 - 为页面交互限制管理器配置 URL 筛选器列表。 配置列表后，页面交互限制管理器将在允许列表中的页面上可用。 这些页面可以通过 API 将敏感度标签发送到平台。

  • 敏感度信息公开 - CoreWebView2 现在公开属性 SensitivityInfo 和 SensitivityInfoChanged 事件，使应用程序能够侦听敏感度标签信息的更新。

敏感度标签支持最初仅在 Win32 上提供。 计划在未来版本中支持 .NET 和 WinRT。

升级到第 2 阶段 (预发行版中的稳定)

在此预发布 SDK 中，没有 API 从第 1 阶段：预发行版中的实验性升级到第 2 阶段：在预发布中稳定。

Bug 修复

此预发布 SDK 包含以下 bug 修复。

仅限运行时
  • 修复了文件系统访问权限上下文中的悬空指针。
  • 修复了在 WinUI3 中拖放期间 UI 挂起问题。
  • 修复了触发权限警报弹出窗口的本地网络访问问题。
  • 解决了辅助功能树中显示额外区域的问题。
  • 修复了默认浏览器帧中的下载不起作用的问题。
仅 SDK
  • 修复了 的 WebView2Loader.dllBinSkim 错误。

1.0.3485.44

发布日期：2025 年 9 月 8 日

用于 WebView2 SDK 1.0.3485.44 的 NuGet 包

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

常规更改

此发布 SDK 侧重于通过后台改进使 WebView2 更好地工作。

  • 测试基础结构已得到加强。
  • API 的验证已得到增强，以确保 API 在不同方案中可靠地执行。

这些基础改进为生成 WebView2 应用提供了经过全面测试的稳定功能。

升级到第 3 阶段 (在发布) 中稳定

在此发布 SDK 中，没有其他 API 从阶段 2：在预发行版中稳定升级到第 3 阶段：稳定发布。

Bug 修复

此发布 SDK 中没有 bug 修复。

1.0.3530-prerelease

发布日期：2025 年 9 月 8 日

用于 WebView2 SDK 1.0.3530-prerelease 的 NuGet 包

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

常规更改

此预发行 SDK 侧重于通过后台改进使 WebView2 更好地工作。

  • 测试基础结构已得到加强。
  • API 的验证已得到增强，以确保 API 在不同方案中可靠地执行。

这些基础改进为生成 WebView2 应用提供了经过全面测试的稳定功能。

升级到预发行版) 中的第 1 阶段 (实验

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

升级到第 2 阶段 (预发行版中的稳定)

在此预发布 SDK 中，没有 API 从第 1 阶段：预发行版中的实验性升级到第 2 阶段：在预发布中稳定。

Bug 修复

此预发布 SDK 包含以下 bug 修复。

仅 SDK
  • 修复了 WPF 合成控制器中的内存泄漏问题。

1.0.3405.78

发布日期：2025 年 8 月 11 日

用于 WebView2 SDK 1.0.3405.78 的 NuGet 包

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

升级到第 3 阶段 (在发布) 中稳定

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

(查找 API) 自定义查找行为

Find API 允许以编程方式控制 Find 作，并允许将以下功能添加到应用：

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

查找 PDF 文档的 API 存在已知问题。 在 WebView2 控件中查看 PDF 文档时， “查找” 功能当前仅提供第一个索引和找到的匹配项数。 例如，如果字符串在 PDF 中出现三次，则 UI 将显示 1/3 ，并且不支持以编程方式调用 Next 或 Previous。

我们正在积极调查这些问题，建议使用 WebView2Feedback 存储库报告遇到的任何问题。

Bug 修复

仅限运行时
  • 修复了 Windows Server 和 Windows 10 上的 Devtools 崩溃。

1.0.3477-prerelease

发布日期：2025 年 8 月 11 日

用于 WebView2 SDK 1.0.3477-prerelease 的 NuGet 包

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

升级到预发行版) 中的第 1 阶段 (实验

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

升级到第 2 阶段 (预发行版中的稳定)

在此预发布 SDK 中，没有 API 从第 1 阶段：预发行版中的实验性升级到第 2 阶段：在预发布中稳定。

Bug 修复

仅限运行时
  • 修复 put_UserAgent 了对服务辅助角色不起作用的问题。
  • 修复了 Windows Server 和 Windows 10 上的 Devtools 崩溃。
  • 调用 remove_BrowserProcessExited后删除了浏览器进程跟踪。
  • 修复了异步函数调用中的 hostObject 内存泄漏问题。
  • 修复了长时间点击后触摸在视觉对象托管中不起作用的修复问题。

1.0.3351.48

发布日期：2025 年 7 月 1 日

用于 WebView2 SDK 1.0.3351.48 的 NuGet 包

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

升级到第 3 阶段 (在发布) 中稳定

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

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

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

Bug 修复

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

1.0.3415-prerelease

发布日期：2025 年 7 月 14 日

用于 WebView2 SDK 1.0.3415-prerelease 的 NuGet 包

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

升级到预发行版) 中的第 1 阶段 (实验

以下 API 处于第 1 阶段：预发行版中的实验性，并已添加到此预发行版 SDK 中。

(WebView2 辅助角色 API) 启用后台处理和脱机支持

WebView2 辅助角色 API 允许主机应用程序与 Web 辅助角色交互，以从主线程卸载任务、提高响应能力并支持后台作。 这些 Web 辅助角色包括专用辅助角色、共享辅助角色和服务辅助角色。

这些 API 提供：

  • 生命周期事件： 监视辅助角色的创建和销毁。
  • 消息传递接口： 使用 PostMessage 和 WebMessageReceived与 辅助角色通信。
  • 辅助角色管理： 查询和检索辅助角色注册和实例。
(窗口控件覆盖 API) 呈现自定义标题栏

通过窗口控件覆盖 API，开发人员可以通过呈现描述文字按钮来创建自定义标题栏， (直接在 WebView2 窗口中最小化、最大化、还原、关闭) 。 窗口控件覆盖显示在 WebView 的顶部，并与应用的 UI 无缝集成。

在以下情况下使用此 API：

  • 你想要将默认 OS 标题栏替换为完全自定义的应用内标题栏。
  • 你正在使用非客户端区域功能，例如 app-region: drag 和 IsNonClientRegionSupportEnabled。

此 API 非常适合需要新式沉浸式 UI 体验的应用。

升级到第 2 阶段 (预发行版中的稳定)

以下 API 已从阶段 1：预发行版中的实验性升级到阶段 2：预发行版中的稳定版，并包含在此预发行版 SDK 中。

(查找 API) 自定义查找行为

Find API 允许以编程方式控制 Find 作，并允许将以下功能添加到应用：

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

查找 PDF 文档的 API 存在已知问题。 在 WebView2 控件中查看 PDF 文档时， “查找” 功能当前仅提供第一个索引和找到的匹配项数。 例如，如果字符串在 PDF 中出现三次，则 UI 将显示 1/3 ，并且不支持以编程方式调用 Next 或 Previous。

我们正在积极调查这些问题，建议使用 WebView2Feedback 存储库报告遇到的任何问题。

Bug 修复

仅限运行时
  • 修复了视觉对象托管中对话框的黑盒问题。
  • 修复 put_UserAgent 了对服务辅助角色不起作用的问题。
  • 修复了 Windows Server 和 Windows 10 上的 DevTools 崩溃。

另请参阅

API 参考：

  • Last updated on