WebView2 SDK 的发行说明

WebView2 发布 SDK 和预发布 SDK 中提供了以下新功能和 bug 修复，适用于过去一年的 SDK。

预发行版 SDK 1.0.4015-prerelease，适用于 Runtime 149 (2026 年 5 月 11 日)

发布日期：2026 年 5 月 11 日

用于 WebView2 SDK 1.0.4015-prerelease 的 NuGet 包

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

中断性变更

EnhancedSecurityModeLevel 替换为 EnhancedSecurityModeState

属性 CoreWebView2Profile.EnhancedSecurityModeLevel 和 CoreWebView2EnhancedSecurityModeLevel 枚举已弃用，并将在将来的版本中删除。 替换 WebView2 应用程序中这些 API 的所有用法，如下所示。

旧属性 CoreWebView2Profile.EnhancedSecurityModeLevel控制是否为与配置文件关联的所有 WebView2 实例启用或禁用增强安全模式 (ESM) 。 此属性已重命名为 EnhancedSecurityModeState，以更清楚地传达增强安全模式的状态。

在此更改之前： 属性 CoreWebView2Profile.EnhancedSecurityModeLevel 使用 CoreWebView2EnhancedSecurityModeLevel 具有 值 Off 和 Strict的枚举。

此更改后： 属性 CoreWebView2Profile.EnhancedSecurityModeState 使用 CoreWebView2EnhancedSecurityModeState 值为 Disabled 和 Enabled的枚举：

  • CoreWebView2EnhancedSecurityModeState.Disabled — 增强的安全模式已禁用。

    • 替换 CoreWebView2EnhancedSecurityModeLevel.Off。

  • CoreWebView2EnhancedSecurityModeState.Enabled — 已启用增强的安全模式。

    • 禁用 JavaScript 实时 (JIT) 编译。
    • 启用其他操作系统保护。
    • 替换 CoreWebView2EnhancedSecurityModeLevel.Strict。

另请参阅：

第 1 阶段 (实验性 API：预发布) 中的实验性

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

增强的安全模式状态

上的 EnhancedSecurityModeStateCoreWebView2Profile 属性控制是否为与配置文件关联的所有 WebView2 实例启用或禁用增强安全模式 (ESM) 。

启用后，增强的安全模式会禁用 JavaScript 实时 (JIT) 编译，并启用其他操作系统保护，减少攻击面，但代价是 JavaScript 性能的一些代价。

默认值为 Disabled。 更改会立即应用于新导航;现有页面需要重新加载。

此设置不会保留，在销毁并重新创建配置文件时重置。

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

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

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

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

这些 API 提供：

  • 生命周期事件： 监视辅助角色的创建和销毁。
  • 消息传递接口： 使用 PostMessage 和 WebMessageReceived与辅助角色通信;具体来说：
    • CoreWebView2ServiceWorker.PostWebMessageAsJson
    • CoreWebView2ServiceWorker.PostWebMessageAsString
    • CoreWebView2DedicatedWorker.PostWebMessageAsJson
    • CoreWebView2DedicatedWorker.PostWebMessageAsString
    • CoreWebView2ServiceWorker.WebMessageReceived
    • CoreWebView2DedicatedWorker.WebMessageReceived
    • chrome.webview.postMessage
    • 不： chrome.webview.postMessageWithAdditionalObjects
  • 辅助角色管理： 查询和检索辅助角色注册和实例。

Bug 修复

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

仅限运行时
  • 修复了 UWP 中的双字符。
  • 修复了 Caption 控件的背景色设置 API。 此更改后，应用还必须截获关闭呼叫并自行处理以关闭应用。
  • 修复了 iframe 的网络事件的转发，其中 iframe 具有其自己的隔离 CDP 会话。
  • 改进了在服务辅助角色上调用发布消息 (（如 CoreWebView2ServiceWorker.PostWebMessageAsJson 或 chrome.webview.postMessage) ）时的错误处理。
  • 减少了 中的 GetDefaultHostAppExeName字符串分配。
  • 修复了更新程序问题：在安装新版本后删除当前使用的 WebView2 运行时，导致在已在运行的应用中创建新控制器时崩溃。

版本 SDK 1.0.3967.48，适用于运行时 148 (2026 年 5 月 11 日)

发布日期：2026 年 5 月 11 日

用于 WebView2 SDK 1.0.3967.48 的 NuGet 包

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

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

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

Bug 修复

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

仅限运行时
  • 修复了更新程序问题：在安装新版本后删除当前使用的 WebView2 运行时，导致在已在运行的应用中创建新控制器时崩溃。

预发行版 SDK 1.0.3965-prerelease，适用于 Runtime 148 (2026 年 4 月 13 日)

发布日期：2026 年 4 月 13 日

用于 WebView2 SDK 1.0.3965-prerelease 的 NuGet 包

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

中断性变更

事件的精细进程失败原因ProcessFailed

当 WebView2 相关进程 (（如呈现器或 GPU 进程）意外退出时，将ProcessFailed触发) 该事件，使应用能够使用恢复逻辑或诊断做出响应。

在此更改之前：属性 CoreWebView2ProcessFailedEventArgs.Reason 返回了 Unexpected 三个不同的退出方案， (正常退出、异常退出和代码完整性故障) ，使应用无法区分它们。

此更改后：启用功能标志后 msWebView2GranularProcessFailedReason ， CoreWebView2ProcessFailedEventArgs.Reason 属性将返回以下新的精细 CoreWebView2ProcessFailedReason 枚举值，而不是 Unexpected：

  • NormalExit — 进程通常退出 (退出代码 0) 。

  • AbnormalExit — 进程异常退出 (非零退出代码) ，但未崩溃或被终止。

  • IntegrityFailure — OS 由于代码完整性失败（例如 DLL 未能通过 Windows 代码完整性验证时）终止了进程。

功能 msWebView2GranularProcessFailedReason 标志在版本 148 和 149 中默认处于禁用状态，为应用提供两个版本来主动测试。 从版本 150 开始，默认情况下将启用该功能，并且应用将接收粒度值。 若要验证 WebView2 应用的行为，请启用功能标志，如下所示：

set WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--enable-features=msWebView2GranularProcessFailedReason

这是运行时和 SDK 的 bug 修复。 这些枚举成员是现有稳定 API 的修改，作为此预发行版 SDK 的一部分提供。

另请参阅：

第 1 阶段 (实验性 API：预发布) 中的实验性

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

用于 WebView2 的源配置 API

源配置 API 使 WebView2 应用能够基于托管内容的源应用不同的功能和安全策略。 默认情况下，WebView2 对所有源强制实施统一策略。 此 API 允许应用选择性地启用或禁用特定功能 (，例如针对单个源或源模式的增强安全模式) 。

使用 上的 SetOriginFeaturesCoreWebView2Profile 方法为一个或多个源配置功能设置。 源可以指定为精确字符串 (，例如 https://contoso.com) 或通配符模式， (例如 https://[*.]contoso.com) 来匹配子域、协议或端口。

当多个配置应用于同一源时，最具体的模式优先，按主机名、方案、端口进行评估。

用于 GetEffectiveFeaturesForOrigin 异步检索给定源的计算特征设置。

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

以下枚举成员是现有稳定 API 的修改，并作为此预发行版 SDK 的一部分提供。

事件的精细进程失败原因ProcessFailed

通过为 CoreWebView2ProcessFailedReason 属性返回CoreWebView2ProcessFailedEventArgs.Reason的CoreWebView2ProcessFailedReason.Unexpected枚举添加更精细的值来补充枚举成员。

这是一项重大更改;请参阅上述事件的精细进程失败原因ProcessFailed。

Bug 修复

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

运行时和 SDK
  • 通过为 CoreWebView2ProcessFailedReason 属性返回CoreWebView2ProcessFailedEventArgs.Reason的CoreWebView2ProcessFailedReason.Unexpected枚举添加更精细的值来补充枚举成员。 这是一项重大更改。 请参阅上述事件的精细进程失败原因ProcessFailed。
仅限运行时

  • 修复了 中的WebView2CompositionControl“打印”对话框下拉列表选择问题。 (问题 #5195)

  • 已禁用 WebView2 的域操作组件。

  • 已 WebUSBDetector 禁用 WebView2 通知。

  • 修复了过时的 ICoreWebView2Profile3::get_PreferredTrackingPreventionLevel。

  • 修复了 WDP 客户端无法连接到远程调试服务器。

  • 修复了 WPF 示例应用的问题，即关闭窗口会留下挥之不去的 WPF 进程。

仅 SDK
  • 为 WebView2 中的浏览器进程崩溃启用了直方图日志记录。

版本 SDK 1.0.3912.50，适用于运行时 147 (2026 年 4 月 13 日)

发布日期：2026 年 4 月 13 日

用于 WebView2 SDK 1.0.3912.50 的 NuGet 包

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

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

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

Bug 修复

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

仅限运行时

  • 已禁用 WebView2 的域操作组件。

  • 修复了 WDP 客户端无法连接到远程调试服务器。

预发行版 SDK 1.0.3908-prerelease，适用于 Runtime 147 (2026 年 3 月 16 日)

发布日期：2026 年 3 月 16 日

用于 WebView2 SDK 1.0.3908-prerelease 的 NuGet 包

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

第 1 阶段 (实验性 API：预发布) 中的实验性

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

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

以下 API 跳过了第 1 阶段：预发行版中的实验性，并已直接添加到阶段 2：在预发布中稳定，并包含在此预发行版 SDK 中。

管理 Web 内容的持久性存储权限

该 PersistentStorage 权限允许 WebView2 应用处理来自 Web 内容的请求，以持久保存由存储 API、服务辅助角色和相关技术创建的数据。 权限 PersistentStorage 是枚举中的 CoreWebView2PermissionKind 枚举成员。

授予此权限后，浏览器不会在磁盘空间不足的情况下逐出存储的数据。 这可确保站点的可靠脱机和缓存行为。

Bug 修复

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

仅限运行时

  • 修复了断开屏幕连接无法正确更改屏幕分辨率的 bug。

  • 修复了 中的 window.getScreenDetails()每监视器 DPI。 (问题 #4826)

  • 已禁用 WebView2 的域操作组件。

  • 修复了打印 PDF 时打印到 PDF API 失败的问题。 (问题 #5499)

  • 修复了导致“讲述人”宣布没有任何 UI 的结构 HWND的问题。

  • 修复了 WebView2 透明度。

  • 修复了用于设置 Caption 控件背景色的 API。

版本 SDK 1.0.3856.49，适用于运行时 146 (2026 年 3 月 16 日)

发布日期：2026 年 3 月 16 日

用于 WebView2 SDK 1.0.3856.49 的 NuGet 包

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

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

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

Bug 修复

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

仅限运行时
  • 修复了打印 PDF 时打印到 PDF API 失败的问题。 (问题 #5499)

预发行版 SDK 1.0.3848-prerelease，适用于 Runtime 146 (2026 年 2 月 16 日)

发布日期：2026 年 2 月 16 日

用于 WebView2 SDK 1.0.3848-prerelease 的 NuGet 包

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

中断性变更

为服务辅助角色启用特定于 WebView2 的 Javascript API

新 AreWebViewScriptApisEnabledForServiceWorkers 设置提供了一种显式且可靠的方法来控制服务辅助角色脚本中特定于 WebView2 的 JavaScript API (chrome.webview) 的可用性。

默认情况下，对 WebView2 应用程序禁用此设置。 未显式启用此设置的应用将无法访问服务辅助角色脚本中特定于 WebView2 的 JavaScript API。 因此，基于 chrome.webview.postMessage 服务辅助角色的通信与 WebView2 主机应用程序的通信将不起作用，除非启用此设置。

今后，WebView2 将依赖 AreWebViewScriptApisEnabledForServiceWorkers 设置作为在服务辅助角色脚本中启用特定于 WebView2 的 JavaScript API 的权威机制。 这可确保可预测、安全和确定性行为。

通过在 WebView2 应用中启用服务辅助角色 JavaScript API 公开，可以主动验证 WebView2 应用的行为。 为此，请将应用配置为启用以下设置：

AreWebViewScriptApisEnabledForServiceWorkers = true

通过在启用此设置的情况下测试 WebView2 应用，可以识别依赖于 WebView2 特定服务辅助角色 API 的任何工作流，例如 chrome.webview.postMessage 服务辅助角色与主机应用程序之间的通信。

目前， chrome 和 chrome.webview 对象可用于使用 ServiceWorkerRegistered 事件时为辅助角色脚本提供服务。 但是，从下一个版本开始， AreWebViewScriptApisEnabledForServiceWorkers 设置将是确定是否向服务辅助角色脚本公开这些对象的唯一机制。 请在下一个版本之前测试此设置，并报告遇到的任何问题。 有关详细信息，请参阅 [中断性变更] 为服务辅助角色启用特定于 WebView2 的 JavaScript API。

另请参阅下面的 控制是否为服务辅助角色启用 WebView 脚本 API。

WebView2 中的本地网络访问 (LNA)

Chromium浏览器引擎引入了本地网络访问 (LNA) 。 LNA 是一项安全功能，可阻止网页向专用或本地网络资源发出请求，除非网页具有访问专用或本地网络资源的显式权限。 此类资源的示例包括 localhost、 192.168.*或 10.*。

目前对 WebView2 应用默认禁用 LNA，但可以通过 标志启用 LNA 支持 msWebViewAllowLocalNetworkAccessChecks 。 对于 WebView2 应用，目前不需要执行任何操作。 有关标志的信息，请参阅 WebView2 浏览器标志中的可用WebView2 浏览器标志。

上游后，Chromium基本代码稳定下来，我们计划在枚举中添加CoreWebView2PermissionKind其他枚举值，以便通过 SetPermissionState 方法支持 LNA。 UWP WebView.PermissionRequested 事件将使用这些新枚举值，使 WebView2 应用显式控制本地网络访问 (LNA) 功能。

可以在 WebView2 应用中主动测试本地网络访问 (LNA) 功能。 若要使用 LNA 功能测试应用，请使用以下标志启动 WebView2 应用：

--enable-features=LocalNetworkAccessChecks,msWebViewAllowLocalNetworkAccessChecks

通过在使用此标志启动时测试应用，可以识别可能受 LNA 功能影响的任何工作流。

LNA 功能稳定后，我们将共享用于启用 LNA 功能的更新时间线。 有关详细信息，请参阅 WebView2 中的 [中断性变更] 本地网络访问 (LNA) - 推出计划。

第 1 阶段 (实验性 API：预发布) 中的实验性

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

控制是否为服务辅助角色启用 WebView 脚本 API

使用 上的 AreWebViewScriptApisEnabledForServiceWorkersCoreWebView2Profile 属性控制是否为服务辅助角色启用了 WebView 脚本 API。

另请参阅上文 为服务辅助角色启用特定于 WebView2 的 Javascript API。

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

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

Bug 修复

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

仅限运行时

  • 修复了删除区域中所有选项时 PDF 工具栏消失的修复问题。 (问题 #4738)

  • 修复了当 Windows 搜索在隐藏后变为可见时发生的白闪烁。

  • 修复了标题栏阴影，使其不显示在透明 WebView2 控件中。 (问题 #5492)

  • 修复了 WebView2 透明度。

  • 修复了本地网络访问 (LNA) 提示问题，方法是在 WebView2 中禁用 LNA 检查。

版本 SDK 1.0.3800.47，适用于 Runtime 145 (2026 年 2 月 16 日)

发布日期：2026 年 2 月 16 日

用于 WebView2 SDK 1.0.3800.47 的 NuGet 包

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

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

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

Bug 修复

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

仅限运行时

  • 修复了标题栏阴影，使其不显示在透明 WebView2 控件中。 (问题 #5492)

  • 修复了本地网络访问 (LNA) 提示问题，方法是在 WebView2 中禁用 LNA 检查。

  • 修复了 WebView2 透明度。

预发行版 SDK 1.0.3796-prerelease，适用于 Runtime 145 (2026 年 1 月 19 日)

发布日期：2026 年 1 月 19 日

用于 WebView2 SDK 1.0.3796-prerelease 的 NuGet 包

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

第 1 阶段 (实验性 API：预发布) 中的实验性

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

增强的安全模式级别

增强的安全模式级别 API 支持为 WebView2 实例配置增强的安全模式 (ESM) 。 ESM 通过禁用 JavaScript 实时 (JIT) 编译并启用其他操作系统保护，降低了与内存相关的漏洞的风险。

若要控制共享同一配置文件的所有 WebView2 实例的 ESM 级别，请在 (或 ICoreWebView2ExperimentalProfile9) 上使用 EnhancedSecurityModeLevelCoreWebView2Profile 属性：

  • Off使用 值可完全禁用增强的安全模式 (默认行为) 。

  • Strict使用 值为所有站点启用增强的安全性。 这会禁用 JIT 编译并应用其他 OS 级保护，从而提高安全性，但可能会降低 JavaScript 性能。

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

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

Bug 修复

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

仅限运行时
  • 修复了 chrome.webview 不可用问题。
  • 禁用了网络时间的后台更新。
仅 SDK

版本 SDK 1.0.3719.77，适用于运行时 144 (2026 年 1 月 27 日)

发布日期：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

预发行版 SDK 1.0.3712-prerelease，适用于 Runtime 144 (2025 年 12 月 8 日)

发布日期：2025 年 12 月 8 日

用于 WebView2 SDK 1.0.3712-prerelease 的 NuGet 包

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

第 1 阶段 (实验性 API：预发布) 中的实验性

以下 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。

版本 SDK 1.0.3650.58，适用于运行时 143 (2025 年 12 月 8 日)

发布日期：2025 年 12 月 8 日

用于 WebView2 SDK 1.0.3650.58 的 NuGet 包

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

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

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

Bug 修复

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

预发行版 SDK 1.0.3650-prerelease，适用于 Runtime 143 (2025 年 11 月 7 日)

发布日期：2025 年 11 月 7 日

用于 WebView2 SDK 1.0.3650-prerelease 的 NuGet 包

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

第 1 阶段 (实验性 API：预发布) 中的实验性

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

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

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

Bug 修复

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

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

版本 SDK 1.0.3595.46，适用于运行时 142 (2025 年 11 月 3 日)

发布日期：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 修复。

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

预发行版 SDK 1.0.3590-prerelease，适用于 Runtime 142 (2025 年 10 月 7 日)

发布日期：2025 年 10 月 7 日

用于 WebView2 SDK 1.0.3590-prerelease 的 NuGet 包

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

第 1 阶段 (实验性 API：预发布) 中的实验性

以下 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 错误。

版本 SDK 1.0.3537.50，适用于运行时 141 (2025 年 10 月 6 日)

发布日期：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 错误。

预发行版 SDK 1.0.3530-prerelease，适用于 Runtime 141 (2025 年 9 月 8 日)

发布日期：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 阶段 (实验性 API：预发布) 中的实验性

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

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

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

Bug 修复

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

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

版本 SDK 1.0.3485.44，适用于运行时 140 (2025 年 9 月 8 日)

发布日期：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 修复。

预发行版 SDK 1.0.3477-prerelease，适用于 Runtime 140 (2025 年 8 月 11 日)

发布日期：2025 年 8 月 11 日

用于 WebView2 SDK 1.0.3477-prerelease 的 NuGet 包

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

第 1 阶段 (实验性 API：预发布) 中的实验性

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

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

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

Bug 修复

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

预发行版 SDK 1.0.3415-prerelease，适用于 Runtime 140 (2025 年 7 月 14 日)

发布日期：2025 年 7 月 14 日

用于 WebView2 SDK 1.0.3415-prerelease 的 NuGet 包

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

第 1 阶段 (实验性 API：预发布) 中的实验性

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

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

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

这些 API 提供：

  • 生命周期事件： 监视辅助角色的创建和销毁。
  • 消息传递接口： 使用 PostMessage 和 WebMessageReceived与辅助角色通信;具体来说：
    • CoreWebView2ServiceWorker.PostWebMessageAsJson
    • CoreWebView2ServiceWorker.PostWebMessageAsString
    • CoreWebView2DedicatedWorker.PostWebMessageAsJson
    • CoreWebView2DedicatedWorker.PostWebMessageAsString
    • CoreWebView2ServiceWorker.WebMessageReceived
    • CoreWebView2DedicatedWorker.WebMessageReceived
    • chrome.webview.postMessage
    • 不： chrome.webview.postMessageWithAdditionalObjects
  • 辅助角色管理： 查询和检索辅助角色注册和实例。
(窗口控件覆盖 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 崩溃。

版本 SDK 1.0.3405.78，适用于运行时 139 (2025 年 8 月 11 日)

发布日期：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 崩溃。

版本 SDK 1.0.3351.48，适用于运行时 138 (2025 年 7 月 1 日)

发布日期：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 修复

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

预发行版 SDK 1.0.3344-prerelease，适用于 Runtime 138 (2025 年 6 月 3 日)

发布日期：2025 年 6 月 3 日

用于 WebView2 SDK 1.0.3344-prerelease 的 NuGet 包

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

第 1 阶段 (实验性 API：预发布) 中的实验性

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

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

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

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

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

Bug 修复

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

版本 SDK 1.0.3296.44，适用于运行时 137 (2025 年 6 月 3 日)

发布日期：2025 年 6 月 3 日

用于 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 加载过程中出现中断性白闪烁。

Bug 修复

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

预发行版 SDK 1.0.3296-prerelease，适用于 Runtime 137 (2025 年 5 月 12 日)

发布日期：2025 年 5 月 12 日

用于 WebView2 SDK 1.0.3296-prerelease 的 NuGet 包

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

第 1 阶段 (实验性 API：预发布) 中的实验性

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

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

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

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

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

Bug 修复

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

另请参阅

API 参考：

  • Last updated on