WebView2 发布 SDK 和预发布 SDK 中提供了以下新功能和 bug 修复,适用于过去一年的 SDK。
适用于运行时 144 的版本 SDK 1.0.3719.77
发布日期:2026 年 1 月 27 日
用于 WebView2 SDK 1.0.3719.77 的 NuGet 包
为了完全实现 API 兼容性,此 WebView2 SDK 版本需要 WebView2 运行时版本 144.0.3719.77 或更高版本。
升级到第 3 阶段 (在发布) 中稳定
以下 API 已从阶段 2:在预发行版中稳定升级为阶段 3:在发布中稳定,现在已包含在此发布 SDK 中。
自定义拖放行为 (DragStarting API)
在可视化托管模式下运行时,API DragStarting 会替代默认的拖放行为。 当用户在 WebView2 中启动拖动作时,事件 DragStarting 会通知应用,并提供使用自己的逻辑替代默认 WebView2 拖动作所需的状态。
- 在 上
ICoreWebView2CompositionController5使用DragStarting添加在拖动作启动时调用的事件处理程序。 - 使用
ICoreWebView2DragStartingEventArgs启动自己的拖动作。-
GetDeferral使用 方法可执行任何异步拖动逻辑,并在以后重新调用 WebView。 -
Handled使用 属性让 WebView2 知道是否使用自己的拖动逻辑。
-
Bug 修复
此发布 SDK 包含以下 bug 修复。
仅限运行时
- 修复了
chrome.webview不可用问题。
仅 SDK
- 添加了 WebView2 应用的性能最佳做法一文,该文章介绍了如何提高 WebView2 应用的启动速度、内存使用率和响应能力。
适用于运行时 145 的预发行版 SDK 1.0.3796-prerelease
发布日期:2026 年 1 月 19 日
用于 WebView2 SDK 1.0.3796-prerelease 的 NuGet 包
为了完全实现 API 兼容性,此预发布版本的 WebView2 SDK 需要Microsoft Edge 版本 145.0.3796.0 或更高版本随附的 WebView2 运行时。
升级到预发行版) 中的第 1 阶段 (实验
以下 API 处于第 1 阶段:预发行版中的实验性,并已添加到此预发行版 SDK 中。
增强的安全模式级别
增强的安全模式级别 API 支持为 WebView2 实例配置增强的安全模式 (ESM) 。 ESM 通过禁用 JavaScript 实时 (JIT) 编译并启用其他作系统保护,降低了与内存相关的漏洞的风险。
若要控制共享同一配置文件的所有 WebView2 实例的 ESM 级别,请在 (或 ICoreWebView2ExperimentalProfile9) 上使用 EnhancedSecurityModeLevelCoreWebView2Profile 属性:
Off使用 值可完全禁用增强的安全模式 (默认行为) 。Strict使用 值为所有站点启用增强的安全性。 这会禁用 JIT 编译并应用其他 OS 级保护,从而提高安全性,但可能会降低 JavaScript 性能。
CoreWebView2EnhancedSecurityModeLevel Enum
CoreWebView2EnhancedSecurityModeLevel.OffCoreWebView2EnhancedSecurityModeLevel.Strict
CoreWebView2Profile类:
升级到第 2 阶段 (预发行版中的稳定)
在此预发布 SDK 中,没有 API 从第 1 阶段:预发行版中的实验性升级到第 2 阶段:在预发布中稳定。
Bug 修复
此预发布 SDK 包含以下 bug 修复。
仅限运行时
- 修复了
chrome.webview不可用问题。 - 禁用了网络时间的后台更新。
仅 SDK
- 添加了 WebView2 应用的性能最佳做法一文,该文章介绍了如何提高 WebView2 应用的启动速度、内存使用率和响应能力。
1.0.3650.58
发布日期:2025 年 12 月 8 日,运行时 143
用于 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 日,运行时 144
用于 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) 。
CoreWebView2EnvironmentOptions类CoreWebView2AllowedPortRangeScope 枚举
CoreWebView2AllowedPortRangeScope.DefaultCoreWebView2AllowedPortRangeScope.WebRtc
CoreWebView2TransportProtocolKind 枚举
CoreWebView2TransportProtocolKind.Udp
升级到第 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 日,运行时 142
用于 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 日,运行时 143
用于 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 日,运行时 141
用于 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 日,运行时 142
用于 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 日,运行时 140
用于 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 日,运行时 141
用于 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 日,运行时 139
用于 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 存储库报告遇到的任何问题。
CoreWebView2类:CoreWebView2Environment类:
Bug 修复
仅限运行时
- 修复了 Windows Server 和 Windows 10 上的 Devtools 崩溃。
1.0.3477-prerelease
发布日期:2025 年 8 月 11 日,运行时 140
用于 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 日,运行时 138
用于 WebView2 SDK 1.0.3351.48 的 NuGet 包
为了完全实现 API 兼容性,此发布版本的 WebView2 SDK 需要 WebView2 运行时版本 138.0.3351.48 或更高版本。
升级到第 3 阶段 (在发布) 中稳定
以下 API 已从阶段 2:在预发行版中稳定升级为阶段 3:在发布中稳定,现在已包含在此发布 SDK 中。
允许输入事件消息通过浏览器窗口传递
类 CoreWebView2ControllerOptions 现在具有一个 AllowHostInputProcessing 属性,它允许用户输入事件消息 (键盘、鼠标、触摸或笔) 通过浏览器窗口,由应用进程窗口接收。
-
CoreWebView2ControllerOptions类:
Bug 修复
仅限运行时
- 修复了视觉对象托管中对话框的黑盒问题。
1.0.3415-prerelease
发布日期:2025 年 7 月 14 日,运行时 140
用于 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与 辅助角色通信。 - 辅助角色管理: 查询和检索辅助角色注册和实例。
-
CoreWebView2类:
-
CoreWebView2Frame类:
-
CoreWebView2Profile类:
-
CoreWebView2ServiceWorkerRegistration 类
- CoreWebView2ServiceWorkerRegistration.ActiveServiceWorker 属性
- CoreWebView2ServiceWorkerRegistration.Origin 属性
- CoreWebView2ServiceWorkerRegistration.ScopeUri 属性
- CoreWebView2ServiceWorkerRegistration.ServiceWorkerActivated 事件
- CoreWebView2ServiceWorkerRegistration.TopLevelOrigin 属性
- CoreWebView2ServiceWorkerRegistration.Unregistering 事件
(窗口控件覆盖 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 存储库报告遇到的任何问题。
CoreWebView2类:CoreWebView2Environment类:
Bug 修复
仅限运行时
- 修复了视觉对象托管中对话框的黑盒问题。
- 修复
put_UserAgent了对服务辅助角色不起作用的问题。 - 修复了 Windows Server 和 Windows 10 上的 DevTools 崩溃。
1.0.3296.44
发布日期:2025 年 6 月 3 日,运行时 137
用于 WebView2 SDK 1.0.3296.44 的 NuGet 包
为了完全实现 API 兼容性,此 WebView2 SDK 版本需要 WebView2 运行时版本 137.0.3296.44 或更高版本。
升级到第 3 阶段 (在发布) 中稳定
以下 API 已从阶段 2:在预发行版中稳定升级为阶段 3:在发布中稳定,现在已包含在此发布 SDK 中。
在 WebView2 初始化 (DefaultBackgroundColor API) 上设置默认背景色
DefaultBackgroundColor API 允许用户在初始化时设置 DefaultBackgroundColor 属性。 这可以防止在 WebView2 加载过程中出现中断性白闪烁。
-
CoreWebView2ControllerOptions类:
Bug 修复
仅限运行时
- 修复了打印的 PDF 中的边距。
1.0.3344-prerelease
发布日期:2025 年 6 月 3 日,运行时 138
用于 WebView2 SDK 1.0.3344-prerelease 的 NuGet 包
为了完全实现 API 兼容性,此预发布版本的 WebView2 SDK 需要Microsoft Edge 版本 138.0.3344.0 或更高版本随附的 WebView2 运行时。
升级到预发行版) 中的第 1 阶段 (实验
此预发布 SDK 中未添加任何实验性 API。
升级到第 2 阶段 (预发行版中的稳定)
以下 API 已从阶段 1:预发行版中的实验性升级到阶段 2:预发行版中的稳定版,并包含在此预发行版 SDK 中。
允许输入事件消息通过浏览器窗口传递
类 CoreWebView2ControllerOptions 现在具有一个 AllowHostInputProcessing 属性,它允许用户输入事件消息 (键盘、鼠标、触摸或笔) 通过浏览器窗口,由应用进程窗口接收。
-
CoreWebView2ControllerOptions类:
Bug 修复
仅限运行时
- 修复了触摸事件后鼠标事件不触发的 bug。
- 在 WebView2 控件上禁用了 Web 捕获。
- 修复了 “下载 ”对话框。
- 修复了默认浏览器帧中下载的问题。 (问题 #5196)
- 修复了打印的 PDF 中的边距。
1.0.3240.44
发布日期:2025 年 5 月 5 日,运行时 136
用于 WebView2 SDK 1.0.3240.44 的 NuGet 包
为了完全实现 API 兼容性,此 WebView2 SDK 版本需要 WebView2 运行时版本 136.0.3240.44 或更高版本。
升级到第 3 阶段 (在发布) 中稳定
以下 API 已从阶段 2:在预发行版中稳定升级为阶段 3:在发布中稳定,现在已包含在此发布 SDK 中。
跟踪嵌套 iframe 的导航历史记录 (FrameCreatedEvent API)
FrameCreatedEvent API 支持嵌套 iframe,例如记录二级 iframe 的导航历史记录。 如果没有此 API,WebView2 仅跟踪第一级 iframe,它们是主帧的直接子 iframe。 使用此 API,应用可以订阅嵌套 iframe 创建事件,使应用能够访问嵌套 iframe 的所有属性、方法和事件 CoreWebView2Frame 。
使用此 API 在包含多个级别的 iframe 的页面上管理 iframe 跟踪。 可以选择跟踪以下任一项:
- 只有主页和第一级 iframe (默认行为) 。
- 部分 WebView2 框架树,其中包含感兴趣的特定 iframe。
- 完整的 WebView2 框架树。
-
CoreWebView2Frame类:
Bug 修复
仅限运行时
- 修复了从默认浏览器帧内下载未完成的问题。 (问题 #5196)
- 修复了错误地返回管道名称,导致某些 UWP 应用崩溃的问题。
1.0.3296-prerelease
发布日期:2025 年 5 月 12 日,运行时 137
用于 WebView2 SDK 1.0.3296-prerelease 的 NuGet 包
为了完全实现 API 兼容性,此预发布版本的 WebView2 SDK 需要Microsoft Edge 版本 137.0.3296.0 或更高版本随附的 WebView2 运行时。
升级到预发行版) 中的第 1 阶段 (实验
此预发布 SDK 中未添加任何实验性 API。
升级到第 2 阶段 (预发行版中的稳定)
以下 API 已从阶段 1:预发行版中的实验性升级到阶段 2:预发行版中的稳定版,并包含在此预发行版 SDK 中。
在 WebView2 初始化 (DefaultBackgroundColor API) 上设置默认背景色
DefaultBackgroundColor API 允许用户在初始化时设置 DefaultBackgroundColor 属性。 这可以防止在 WebView2 加载过程中出现中断性白闪烁。
-
CoreWebView2ControllerOptions类:
Bug 修复
仅限运行时
- 修复了“ 查找 栏”在窗口移动后不再显示问题。
- 修复了应用无法通过事件取消导航到登录页的
NavigationStartingbug。 - 修复了从默认浏览器帧内下载未完成的问题。 (问题 #5196)
- 修复了错误地返回管道名称,导致某些 UWP 应用崩溃的问题。
1.0.3179.45
发布日期:2025 年 4 月 7 日,运行时 135
用于 WebView2 SDK 1.0.3179.45 的 NuGet 包
为了完全实现 API 兼容性,此 WebView2 SDK 版本需要 WebView2 运行时版本 135.0.3179.45 或更高版本。
升级到第 3 阶段 (在发布) 中稳定
在此发布 SDK 中,没有其他 API 从阶段 2:在预发行版中稳定升级到第 3 阶段:稳定发布。
Bug 修复
仅限运行时
- 修复了 HTML Select 元素 (<选择>) ,使其可在 WPF 应用中选择。
- 修复了在 WebView2 控件中导航 的问题
edge://crashes。 - 修复了从 WebView2 实例调用 Windows 凭据 UI 时潜在的崩溃和 UI 问题。
- 修复了用户无法使用自动填充信息键入输入字段的 bug。 (问题 #5144)
1.0.3230-prerelease
发布日期:2025 年 4 月 7 日,运行时 136
用于 WebView2 SDK 1.0.3230-prerelease 的 NuGet 包
为了完全实现 API 兼容性,此预发布版本的 WebView2 SDK 需要Microsoft Edge 版本 136.0.3230.0 或更高版本随附的 WebView2 运行时。
升级到预发行版) 中的第 1 阶段 (实验
此预发布 SDK 中未添加任何实验性 API。
升级到第 2 阶段 (预发行版中的稳定)
以下 API 已从阶段 1:预发行版中的实验性升级到阶段 2:预发行版中的稳定版,并包含在此预发行版 SDK 中。
跟踪嵌套 iframe 的导航历史记录 (FrameCreatedEvent API)
FrameCreatedEvent API 支持嵌套 iframe,例如记录二级 iframe 的导航历史记录。 如果没有此 API,WebView2 仅跟踪第一级 iframe,它们是主帧的直接子 iframe。 使用此 API,应用可以订阅嵌套 iframe 创建事件,使应用能够访问嵌套 iframe 的所有属性、方法和事件 CoreWebView2Frame 。
使用此 API 在包含多个级别的 iframe 的页面上管理 iframe 跟踪。 可以选择跟踪以下任一项:
- 只有主页和第一级 iframe (默认行为) 。
- 部分 WebView2 框架树,其中包含感兴趣的特定 iframe。
- 完整的 WebView2 框架树。
-
CoreWebView2Frame类:
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 日,运行时 134
用于 WebView2 SDK 1.0.3124.44 的 NuGet 包
为了完全实现 API 兼容性,此发布版本的 WebView2 SDK 需要 WebView2 运行时版本 134.0.3124.44 或更高版本。
升级到第 3 阶段 (在发布) 中稳定
在此发布 SDK 中,没有其他 API 从阶段 2:在预发行版中稳定升级到第 3 阶段:稳定发布。
Bug 修复
仅限运行时
- 无论开发人员模式是否处于打开状态,都不会通过使用
AddBrowserExtensionAsync在 WebView2 中禁用扩展。 (问题 #5113) - 禁用了网络时间的后台更新。 (问题 #5047)
- 修复了在 时
target="_blank"不显示下载弹出窗口。 (问题 #5063)
1.0.3171-prerelease
发布日期:2025 年 3 月 10 日,运行时 135
用于 WebView2 SDK 1.0.3171-prerelease 的 NuGet 包
为了完全实现 API 兼容性,此预发布版本的 WebView2 SDK 需要Microsoft Edge 版本 135.0.3171.0 或更高版本随附的 WebView2 运行时。
升级到预发行版) 中的第 1 阶段 (实验
此预发布 SDK 中未添加任何实验性 API。
升级到第 2 阶段 (预发行版中的稳定)
在此预发布 SDK 中,没有 API 从第 1 阶段:预发行版中的实验性升级到第 2 阶段:在预发布中稳定。
Bug 修复
运行时和 SDK
仅限运行时
- 修复了“添加到 Chrome”存储安装回归。
- 修复了 UWP 和 WinUI 中的文件夹上传。 (问题 #3275)
- 无论开发人员模式是否处于打开状态,都不会通过使用
AddBrowserExtensionAsync在 WebView2 中禁用扩展。 (问题 #5113) - 禁用了网络时间的后台更新。 (问题 #5047)
- 修复了在 时
target="_blank"不显示下载弹出窗口。 (问题 #5063)
仅 SDK
- 修复了当垃圾回收器在主线程以外的线程上调用
Finalize时可能发生的崩溃。
1.0.3065.39
发布日期:2025 年 2 月 10 日,运行时 133
用于 WebView2 SDK 1.0.3065.39 的 NuGet 包
为了完全实现 API 兼容性,此 WebView2 SDK 版本需要 WebView2 运行时版本 133.0.3065.39 或更高版本。
升级到第 3 阶段 (在发布) 中稳定
在此发布 SDK 中,没有其他 API 从阶段 2:在预发行版中稳定升级到第 3 阶段:稳定发布。
Bug 修复
仅限运行时
- 在“下载”浮出控件中添加了缺少的“关闭”按钮。
- 修复了从不发生 Web 请求响应事件时发生的争用条件。
1.0.3116-prerelease
发布日期:2025 年 2 月 10 日,运行时 134
用于 WebView2 SDK 1.0.3116-prerelease 的 NuGet 包
为了完全实现 API 兼容性,此预发布版本的 WebView2 SDK 需要Microsoft Edge 版本 134.0.3116.0 或更高版本随附的 WebView2 运行时。
升级到预发行版) 中的第 1 阶段 (实验
此预发布 SDK 中未添加任何实验性 API。
升级到第 2 阶段 (预发行版中的稳定)
在此预发布 SDK 中,没有 API 从第 1 阶段:预发行版中的实验性升级到第 2 阶段:在预发布中稳定。
Bug 修复
仅限运行时
- 在“下载”浮出控件中添加了缺少的“关闭”按钮。
- 修复了从不发生 Web 请求响应事件时发生的争用条件。
仅 SDK
- 修复了错误提及
FindPrevious的方法的CoreWebView2Find.FindNext.NET 和 Win32 文档。 方法摘要现在改为提及FindNext。 (问题 #5059)
另请参阅
- 关于 WebView2 SDK 的发行说明
- WebView2 SDK 的存档发行说明
- WebView2 API 概述 - 按功能区域概述了发布 SDK 包中的许多 API。
- 联系 Microsoft Edge WebView2 团队
- Microsoft Edge Web 平台的发行说明
API 参考: