通过

WebView2 SDK 的存档发行说明

  • 项目

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

1.0.2277.86

发布日期：2024 年 2 月 5 日

用于 WebView2 SDK 1.0.2277.86 的 NuGet 包

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

中断性变更

重要

中断性变更：到 的 about:blank 导航现在可通过 NavigationStarting 事件取消。 若要还原为旧行为，请 msWebView2CancellableAboutNavigations 禁用功能标志。

促销

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

  • ExecuteScriptWithResult 如果脚本失败，则提供异常信息。 TryGetResultAsString 将脚本执行结果作为字符串而不是 JSON 获取，以便更方便地与字符串结果交互：

错误修补程序

仅限运行时

  • 确保拼写检查语言以编程方式匹配 put_Language 。 自定义上下文菜单也会使用正确的拼写检查进行更新。 仅 (运行时)

  • 修复了一个 bug，该 bug 停止为加载 AV1 编码视频的某些网站引发 NavigationCompleted 事件。 (仅限运行时) (问题 #3801)

  • 修复了在 WebView 拆解过程中会释放主机进程 COM 资源的问题。 (仅限运行时) (问题 #4226)

  • 修复了加载某些社交媒体应用（如 Facebook、Twitter 和LinkedIn）的 bug。 此更改特定于运行时。 (仅限运行时) (问题 #4281)

1.0.2357-prerelease

发布日期：2024 年 1 月 30 日

用于 WebView2 SDK 1.0.2357-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 添加了运行时选择功能，以支持更多预发布测试和外部测试方案。 开发人员可以指定 ReleaseChannels 以选择在创建环境期间搜索的通道，以及 ChannelSearchKind 选择搜索顺序。
  • 添加了一个新的 API，用于在 WebView2 包含的区域上提供命中测试结果。 对于希望在 WebView2 窗口的非工作区上处理鼠标事件的可视托管应用程序，此 API 非常有用。

促销

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

  • CoreWebView2AcceleratorKeyPressedEventArgs 具有一个新 IsBrowserAcceleratorKeyEnabled 属性，用于控制浏览器是否处理快捷键 (快捷键) ，例如 Ctrl+P 或 F3：
  • 帧进程信息 API（包括 GetProcessExtendedInfos）提供在关联的呈现器进程中主动运行的所有帧的快照集合。 此 API 使主机应用程序能够检测 WebView2 的哪个部分消耗了内存或 CPU 使用率等资源：
  • ExecuteScriptWithResult 如果脚本失败，则提供异常信息。 TryGetResultAsString 将脚本执行结果作为字符串而不是 JSON 获取，以便更方便地与字符串结果交互：
  • CreateFromComICoreWebView2 将现有 ICoreWebView2 对象包装在 实例中 CoreWebView2 ，使 .NET 开发人员能够与在 C++ 中创建的控件进行交互。
  • 若要支持 WebView2 中的浏览器扩展，请为 WinRT 添加 GetBrowserExtensions ：

不适用

  • 添加了对 WebResourceRequested 辅助角色的支持，允许设置筛选器，以便接收 WebResourceRequested 服务辅助角色、共享辅助角色和不同源 iframe 的事件。

错误修补程序

仅限运行时

  • 修复了关闭具有嵌入 PDF 查看器的 WebView 控件可能导致崩溃的 bug。 (仅限运行时) (问题 #3832)

  • 修复了子进程任务栏图标的堆叠问题。 (仅限运行时) (问题 #3245)

  • 修复了为 Edge Cloud Config Service 发送不必要的网络请求的 bug。 (仅限运行时) (问题 #4180)

  • 更新了 CSS 属性的行为 app-region ，以便更改其值会触发页面重新布局。 仅 (运行时)

  • 修复了未注册事件处理程序AcceleratorKeyPressed时无法更新 WebView2 设置的问题put_AreBrowserAcceleratorKeysEnabled。 (仅限运行时) (问题 #4278)

仅 SDK

  • 修复了 .NET 中的 WebView2 控件在 UNC 路径上找不到 WebView2Loader.dll 的问题。 ) 仅 (SDK) (问题 #4081

  • 修复了在 .NET 控件中导致 实例 InvalidOperationException 的一些问题，这些问题对开发人员没有帮助。 (仅限 SDK) (问题 #4272)

1.0.2210.55

发布日期：2023 年 12 月 11 日

用于 WebView2 SDK 1.0.2210.55 的 NuGet 包

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

中断性变更

重要

中断性变更：如果要使用固定版本运行时 v120 或更高版本开发未打包的 Win32 应用，并且面向 Windows 10 设备，则需要 () icacls 运行几个 ACL shell 命令，以避免崩溃，因为 WebView2 中实现了新的安全功能。 请参阅 [中断性变更] 在 Win10 上使用固定版本 v120+ 解压缩的 Win32 应用需要 ACL。 修补程序位于 文章分发应用和 WebView2 运行时， 有关固定版本运行时分发模式的详细信息部分，步骤“在 Windows 10 设备上，从固定版本 120 开始，使用固定版本的未打包 Win32 应用程序的开发人员必须运行以下命令。

促销

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

  • 支持 WebView2 中的浏览器扩展：
  • 帧进程信息 API（包括 GetProcessExtendedInfos）提供在关联的呈现器进程中主动运行的所有帧的快照集合。 此 API 使主机应用程序能够检测 WebView2 的哪个部分消耗了内存或 CPU 使用率等资源：
  • ICoreWebView2AcceleratorKeyPressedEventArgs 具有一个新 IsBrowserAcceleratorKeyEnabled 属性，允许开发人员控制浏览器是否处理快捷键 (快捷键) ，例如 Ctrl+P 或 F3：
  • 添加了对管理配置文件删除的支持：

错误修补程序

  • 在 WinRT JS 投影中添加了对主机对象的异步方法的承诺取消的支持。 有关 的信息 AddHostObjectToScript，请参阅 从 Web 端代码调用本机 WinRT 代码。 (运行时和 SDK)

  • 为 WebView2 API 导航禁用了自动 HTTPS 升级。 (仅限运行时) (问题 #4104)

1.0.2151.40

发布日期：2023 年 11 月 6 日

用于 WebView2 SDK 1.0.2151.40 的 NuGet 包

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

正式发布版

重要

公告：Xbox WebView2 SDK 现已正式发布 (GA) ，并在 Xbox 2310 年 10 月版本 (231018-2200) 提供。 有关更多详细信息，请参阅 适用于 Xbox 的 WebView2 公告。

促销

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

  • 向事件参数添加了源帧信息 NewWindowRequested ，以标识请求的源：
  • 对于 WinRT，已添加选项以在创建 CoreWebView2Environment时管理自定义方案注册：

错误修补程序

  • 修复了创建多个 WebView 可能导致崩溃的可靠性问题。 (仅限运行时) (问题 #3793)

1.0.2194-prerelease

发布日期：2023 年 11 月 6 日

用于 WebView2 SDK 1.0.2194-prerelease 的 NuGet 包

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

促销

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

  • 支持 WebView2 中的浏览器扩展：

错误修补程序

  • 修复了以下问题：在更改监视器规模或在 RDP 和停靠模式之间切换后，WebView2 有时会呈现模糊内容或没有内容。 仅 (运行时)
  • 修复了销毁 WebView2 实例时导致崩溃的问题 TextServicesFoundation 。 仅 (运行时)
  • 修复了从 WebView2 发送但未从应用程序端读取的 Web 消息时 .NET 中的内存泄漏问题。 (运行时和 SDK) (问题 #3794)
  • 修复了导致 ScaleFactor 设置无法对所有 WebView2 打印 API 正常工作的问题。 (仅限运行时) (问题 #4082)

1.0.2088.41

发布日期：2023 年 10 月 16 日

用于 WebView2 SDK 1.0.2088.41 的 NuGet 包

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

促销

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

错误修补程序

  • 修复了导致某些 UWP 应用无法输入文本的问题。 (仅限运行时) (问题 #3805)
  • 修复了使用 Windows PerProcessSystemDPIForceOff 兼容性设置的应用的初始化失败。 (仅限运行时) (问题 #3692)
  • 修复了 WebView2 中的对话框位置偏移 bug。 (仅限运行时) (问题 #3763)

1.0.2164-prerelease

发布日期：2023 年 10 月 18 日

用于 WebView2 SDK 1.0.2164-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • FailureSourceModulePath向 ProcessFailedEventArgs 类型添加了 属性，以指定在 Windows 代码完整性失败的情况下导致崩溃的模块的完整路径，即当进程以 退出时。STATUS_INVALID_IMAGE_HASH

错误修补程序

  • 在 PrintToPDF API 中添加了对其他页面设置的支持 (PageRange 和 PagesPerSheet) 。 (仅限运行时) (问题 #3719)
  • 未正确处理到扩展资源文件的导航，现在已使用正确的处理方法进行了修复。 (仅限运行时) (问题 #3728)
  • 修复了导致某些 UWP 应用无法输入文本的问题。 (仅限运行时) (问题 #3805)
  • 修复了使用 Windows PerProcessSystemDPIForceOff 兼容性设置的应用的初始化失败。 (仅限运行时) (问题 #3692)
  • 删除了在系统默认浏览器设置更改时收集数据的监视器。 仅 (运行时)
  • 修复了 WebView2 中的对话框位置偏移 bug。 (仅限运行时) (问题 #3763)
  • 修复了 如果 设置为 null，则事件NewWindow中的NewWindowRequested崩溃。 仅 (运行时)

1.0.2045.28

发布日期：2023 年 9 月 18 日

用于 WebView2 SDK 1.0.2045.28 的 NuGet 包

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

促销

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

错误修补程序

  • 默认情况下禁用了鼠标手势功能。 (仅限运行时) (问题 #3737)
  • 修复了视觉对象托管鼠标滚轮滚动间歇性中断的 bug。 仅 (运行时)
  • 修复了在 WebView2 中下载 APK 文件导致 WebView2 浏览器进程崩溃的 bug。 (仅限运行时) (问题 #3569)

1.0.2106-prerelease

发布日期：2023 年 9 月 20 日

用于 WebView2 SDK 1.0.2106-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 帧进程信息 API（包括 GetProcessExtendedInfos）提供在关联的呈现器进程中主动运行的所有帧的快照集合。 此 API 使主机应用程序能够检测 WebView2 的哪个部分消耗了内存或 CPU 使用率等资源：

促销

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

  • 对于 WinRT，已添加选项以在创建 CoreWebView2Environment时管理自定义方案注册：
  • 向事件参数添加了源帧信息 NewWindowRequested ，以标识请求的源：

错误修补程序

运行时
  • 更新了屏幕截图 UI 以删除对选项卡的提及。 仅 (运行时)
  • 修复了不使用打印机上默认 DPI 进行打印的 bug PrintAsync 。 (仅限运行时) (问题 #3709)
  • 修复应用以其他管理员用户身份运行时 WebView 创建失败的问题。 (仅限运行时) (问题 #3738)
  • 修复了阻止在 WinUI 3 上为 WebView2 控件设置自动化名称的 bug。 仅 (运行时)
  • 为使用非常旧的 SDK 的应用启用了新的进程间通信实现。 仅 (运行时)
SDK 版
  • 修复了 属性 CoreWebView2EnvironmentOptions.Language 不会更改 HTTP 标头的 accept-language bug。 仅 (SDK) (问题 #3635)
  • 添加了对较长运行时安装路径的支持。 仅 (SDK)
  • 自定义 URI 方案注册 API 现在可在 WinRT 中运行。 有关 API 名称和链接，请参阅上面的 促销 部分的“自定义方案注册”条目。 仅 (SDK)
运行时和 SDK
  • 修复了运行时在调用 SetPermissionState 时使用无效枚举值意外退出的 bug。 (运行时和 SDK)

1.0.1938.49

发布日期：2023 年 8 月 28 日

用于 WebView2 SDK 1.0.1938.49 的 NuGet 包

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

促销

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

错误修补程序

  • 修复了 API 使用可能会失败的 TextureStream 句柄跟踪 bug。 仅 (运行时)
  • 修复了在后台线程中创建的 WebView2 在创建时不会出现在前台的 bug。 (仅限运行时) (问题 #3584)
  • 修复了以下 bug：WebView2 内容在更改显示配置 (（例如笔记本电脑睡眠）后，有时会以不正确的大小呈现;远程处理;或连接或断开外部显示器) 。 (仅限运行时) (问题 3429)
  • 修复了在某些硬件配置上使用 WebView2 应用时出现蓝屏的 bug。 (仅限运行时) (问题 #3679)

1.0.2065-prerelease

发布日期：2023 年 8 月 30 日

用于 WebView2 SDK 1.0.2065-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 向 NewWindowRequested添加了源帧信息，以支持标识源：

错误修补程序

  • 已禁用在 WebView2 中安装 CRX。 仅 (运行时)
  • 修复了应用应用 DPI 感知兼容性设置时初始化失败的问题。 (仅限运行时) (问题 #3008)
  • 修复了视觉对象托管拥有的窗口无法接受字符输入的 bug。 仅 (运行时)

1.0.1901.177

发布日期：2023 年 7 月 24 日

用于 WebView2 SDK 1.0.1901.177 的 NuGet 包

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

促销

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

  • NavigationKind 获取每个导航的导航类型，例如后退/前进、重载或导航到新文档。
  • ServiceWorkers枚举中的BrowsingDataKinds枚举值指定为源注册的服务辅助角色。

错误修补程序

  • 修复了同时隐藏书签、搜索和 PageSelector 按钮时整个工具栏为空白的 bug。 (仅限运行时) 问题 2866

1.0.1988-prerelease

发布日期：2023 年 7 月 24 日

用于 WebView2 SDK 1.0.1988-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 支持通过 WebView2 发送桌面通知：
  • 通过获取 iframe 的进程信息详细信息，支持监视 iframe 的运行时内存使用情况。
  • 支持 WebView2 中的扩展。
  • 枚举 TextDirectionKind 将文本方向指定为从左到右或从右到左。

错误修补程序

  • CoreWebView2Frame.ExecuteScriptAsync修复了在脚本执行过程中销毁帧时发生的挂起。 问题 3124
  • COMException修复了在重定向后读取WebResourceResponse内容时的 。 问题 3229
  • 修复了针对同一名称调用 CoreWebView2.AddHostObjectToScript 两次挂起的回归。 (仅限运行时) 问题 3539
  • 修复了包含中文字符时PrinterName失败的问题PrintAsync。 问题 3379
  • 修复了在 设置为 false时AreDefaultContextMenusEnabled禁用打印页中的上下文菜单的问题。 问题 3548
  • 从 Web 捕获上下文菜单中删除了视觉搜索。 (仅限运行时) 问题 3426
  • 修复了PrintAsync打印设置为 null时导致 和 PrintToPdfStreamAsync 失败的问题。
  • 从默认的“无 Internet 连接”错误页中删除了“启动游戏”按钮。 仅 (运行时)
  • 修复了确保 WebVivew2Loader 可从 UNC 路径加载的问题。 问题 3465
  • 修复了无效 CoreWebView2PdfToolbarItems.FullScreen 和 CoreWebView2PdfToolbarItems.MoreSettings。
  • 添加了一个锁，用于从多线程访问主机对象。 仅 (运行时)
  • 修复了 (CoreWebView2PdfToolbarItems.MoreSettings的配置选项， CoreWebView2PdfToolbarItems.FullScreen) 在 PDF 预览模式下无效。 问题 3324
  • 删除了 PDF 设置等中的隐藏所有批注选项。 仅 (运行时)
  • 删除了 “显示所有已保存的密码 ”上下文菜单项。 仅 (运行时)

1.0.1823.32

发布日期：2023 年 6 月 5 日

用于 WebView2 SDK 1.0.1823.32 的 NuGet 包

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

促销

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

  • LaunchingExternalUriScheme尝试启动向 OS 注册的 URI 方案时，将引发该事件 (外部 URI 方案) 。
  • MemoryUsageTargetLevel 指定内存消耗级别，例如 low 或 normal。
  • 增强了对多个配置文件的支持，允许为不同的配置文件配置常规自动填充和密码自动保存设置。

1.0.1905-prerelease

发布日期：2023 年 6 月 12 日

用于 WebView2 SDK 1.0.1905-prerelease 的 NuGet 包

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

实验性 API

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

促销

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

  • NavigationKind 获取每个导航的导航类型，例如后退/前进、重载或导航到新文档。
  • ServiceWorkers枚举中的BrowsingDataKinds枚举值指定为源注册的服务辅助角色。
  • LaunchingExternalUriScheme尝试启动向 OS 注册的 URI 方案时，将引发该事件 (外部 URI 方案) 。
  • MemoryUsageTargetLevel 指定内存消耗级别，例如 low 或 normal。

错误修补程序

  • 枚举某些webhosthidden类型时，使用 wv2winrt webhosthidden 输入了无限循环。 仅 (SDK)
  • 在 wv2winrt 工具生成的代码中，调用异步方法时，如果成功但返回nullIAsyncAction而不是 ，则它会崩溃。 仅 (SDK)

1.0.1774.30

发布日期：2023 年 5 月 8 日

用于 WebView2 SDK 1.0.1774.30 的 NuGet 包

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

促销

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

  • 文件 API 允许访问通过 WebMessage传递的 DOM File 对象。
  • 配置文件 Cookie 管理器 API 支持配置文件管理。 属性 CookieManager 使主机应用能够获取配置文件的 Cookie 管理器。

错误修补程序

  • 修复了允许应用在新窗口创建前调用 AddScriptToExecuteOnDocumentCreated 来注入初始脚本的问题。 (问题 #2491)
  • 修复了导致标头 X-Edge-Shopping-Flag 添加到来自 WebView2 的 Web 请求的问题。 (仅限运行时) (问题 #3365)

1.0.1829-prerelease

发布日期：2023 年 5 月 8 日

用于 WebView2 SDK 1.0.1829-prerelease 的 NuGet 包

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

促销

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

  • 增强了对多个配置文件的支持，允许为不同的配置文件配置常规自动填充和密码自动保存设置。

错误修补程序

  • 禁用了显示允许安装扩展的选项的 Chrome Web Store 信息横幅。 (问题 #3312)
  • 修复了自定义菜单项未触发的问题。 (问题 #3300)
  • 修复了使用 WPF 和 SDK 版本 1.0.1722.32（现已弃用）创建 WebView2 时初始化时出现的故障。 (请参阅下面 已弃用 SDK 1.0.1722.32 。) (问题 #3375)
  • 修复了在 PostSharedBufferToScript 发布大约 32000x1MB 缓冲区后停止的 bug。 (仅限运行时) (问题 #3360)
  • 修复了始终在事件回调中 ScriptDialogOpening 进行导航的问题。 (仅限运行时) (问题 #3355)
  • 修复了支持 BackForwardCache 标志的问题。 仅 (运行时)
  • 修复了视觉托管自有窗口的问题，即从窗口外部单击“查找”栏不会激活“查找栏”。

1.0.1722.45

发布日期：2023 年 4 月 13 日

用于 WebView2 SDK 1.0.1722.45 的 NuGet 包

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

SDK 1.0.1722.32 已弃用

WebView2 SDK 1.0.1722.32 已弃用，该包已从 NuGet 的列表中删除。 停止使用包 1.0.1722.32 进行开发。 如果 WebView2 应用使用该包，建议移动到较新的包，例如 WebView2 SDK 1.0.1722.45 或更高版本。

促销

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

  • 管理 SmartScreen API 控制是否启用 SmartScreen。
  • API PermissionKind.WindowManagement 指示权限请求的类型。

1.0.1777-prerelease

发布日期：2023 年 4 月 10 日

用于 WebView2 SDK 1.0.1777-prerelease 的 NuGet 包

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

实验性 API

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

促销

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

  • 文件 API 允许访问通过 WebMessage传递的 DOM File 对象。
  • 配置文件 Cookie 管理器 API 支持配置文件管理。 属性 CookieManager 使主机应用能够获取配置文件的 Cookie 管理器。

错误修补程序

  • 修复了从其他线程释放 WebView 时出现崩溃问题。 (仅限运行时) (问题 #3062)
  • 修复了当包装在 中时焦点被困在 WebView2 控件内的 ContainerControlbug。 (问题 #2835)
  • 通过在 WebView2 中禁用可 .pdf 编辑的临时缓存数据恢复功能，修复了此问题。 (问题 #3274)
  • 禁用了显示允许安装扩展的选项的 Chrome Web Store 信息横幅。 (问题 #3312)
  • 修复了屏幕阅读器无法调出新下载项的问题。
  • 修复了视觉对象托管拥有的窗口未正确映射鼠标指针输入的 bug。
  • 修复了已取消的“另存为”对话框引发的 bugDownloadStarting。 仅 (运行时)

1.0.1661.34

发布日期：2023 年 3 月 20 日

用于 WebView2 SDK 1.0.1661.34 的 NuGet 包

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

促销

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

  • The SharedBuffer API:
  • 用于管理权限的 API：

用于管理跟踪防护的 API：

  • 用于管理控制器脚本区域设置值的 API：

1.0.1724-prerelease

发布日期：2023 年 3 月 20 日

用于 WebView2 SDK 1.0.1724-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 已为收到的 WebMessage 添加了 AdditionalObjects ：
  • 添加了“窗口管理”权限类型：
  • 添加了对启动外部 URI 的支持：
  • 添加了对纹理流式处理的支持：

Environment返回接口的TextureStream接口：

接口 TextureStream ：

ErrorReceivedEventArgs：

WebTextureReceivedEventArgs：

TextureStream 错误类型枚举：

Texture主机写入的接口，以便呈现器将呈现在它上：

呈现器写入的接收 WebTexture 接口，以便主机将对其进行读取：

  • 添加了对配置文件管理的支持：自定义数据分区、Cookie 管理器和配置文件删除：

促销

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

  • 管理智能屏幕 API：

错误修补程序

  • 修复了 中的 PrintAsync bug， PrintToPdfStreamAsync 该 bug 在打印设置为 null 时引发异常。
  • 改进了对提升运行的应用的处理。 仅 (运行时)
  • 添加了对窗口管理权限类型的支持。 (运行时和 SDK)
  • 可靠性改进。 仅 (运行时)

1.0.1587.40

发布日期：2023 年 2 月 15 日

用于 WebView2 SDK 1.0.1587.40 的 NuGet 包

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

促销

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

  • 用于创建 WebView2 环境以管理自定义方案注册的其他选项：

1.0.1671-prerelease

发布日期：2023 年 2 月 15 日

用于 WebView2 SDK 1.0.1671-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 添加了对实验性文件 API 的支持：

促销

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

  • The SharedBuffer API:
  • 权限 API：
  • The ScriptLocale API:

错误修补程序

  • 修复了在收到事件时 BeforeUnload WebView2 未正确关闭的 bug。 (仅限运行时) (问题 #2677)
  • 在 事件中DownloadStartingResultFilePath，在附加事件处理程序时DownloadStarting，先前未显示 UWP 应用程序的正确下载位置。 此问题已修复：现在显示正确的 ResultFilePath 。
  • 修复了调用 方法返回非泛型任务时HostObject引发的 bugSystem.ArgumentException。 (问题 #2787)
  • 修复了 API 中 SharedBuffer 流对象不能很好地与 配合使用 StreamWriter的问题。 (仅限运行时) (问题 #3108)
  • DOM 语音合成 API（如 SpeechSynthesis.getVoices()）现在可在 UWP 应用中使用。 仅 (运行时)
  • 修复了帧销毁时发生的崩溃。 (仅限运行时) (问题 #3062)
  • 修复了在尝试使用短语进行调用 CreateWebResourceResponse 时应用崩溃的 nullreason bug。 仅 (运行时)
  • 选项CoreWebView2.AddHostObjectToScriptchrome.webview.hostObjects.options.ignoreMemberNotFoundError现在在非英语区域设置中有效。 仅 (运行时)
  • 完全启用对 Windows 7 上提升的应用的 “打开文件 ”对话框支持。
  • 修复了 UWP 未显示拥有的窗口的 bug。

1.0.1518.46

发布日期：2023 年 1 月 17 日

用于 WebView2 SDK 1.0.1518.46 的 NuGet 包

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

促销

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

  • 打印 API：
  • 自定义崩溃报告 API：

1.0.1619-prerelease

发布日期：2023 年 1 月 19 日

用于 WebView2 SDK 1.0.1619-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 添加了对权限管理 API 的支持：
  • 添加了对 API 的支持，以禁用后退和前进导航：

促销

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

  • 自定义方案注册 API：
  • 跟踪防护 API：

错误修补程序

  • 在 WebView2 上下文菜单中禁用了 作为配置文件打开链接 。
  • 修复了通过 Ctrl 单击表单提交时缺少的帖子数据。 (问题 #2652)
  • 修复了用户无法获取 PDF 查看器上的自定义上下文菜单的 bug。 (问题 #2607)
  • 修复了同时隐藏 书签、 搜索和 PageSelector 按钮时整个工具栏为空白的 bug。 (问题 #2866)
  • 修复了应用在禁用时尝试将焦点移动到 WebView2 时崩溃的 bug。
  • 修复了组合托管 Web 视图的 WebView2 中的拖放问题。
  • 删除了 WebView2 弹出窗口地址栏中的朗读图标。
  • 修复了 WebView2 中弹出窗口上下文菜单中的意外项。

1.0.1462.37

发布日期：2022 年 12 月 12 日

用于 WebView2 SDK 1.0.1462.37 的 NuGet 包

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

错误修补程序

此 WebView2 SDK 版本具有与 1.0.1466-prerelease 的 Bug 修复相同的 bug 修复。

1.0.1549-prerelease

发布日期：2022 年 12 月 12 日

用于 WebView2 SDK 1.0.1549-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 添加了对区域设置 API 的支持：
  • 添加了对跟踪防护 API 的支持：

促销

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

  • 添加了对打印 API 的支持：
  • 添加了对自定义崩溃报告 API 的支持：

错误修补程序

  • 修复了一些 nullptr 问题，即现在某些将 nullptr 用作输入参数的公共 API 不会使 WebView2 崩溃。
  • 在 WebView2 上下文菜单中禁用了“作为配置文件打开链接”。
  • 修复了同时隐藏书签、搜索和 PageSelector 按钮时整个工具栏为空白的 bug。 (问题 #2866)
  • 通过控件单击修复表单提交中缺少的帖子数据。 (问题 #2652)
  • 修复了用户无法获取 PDF 查看器上的自定义上下文菜单的 bug。 (问题 #2607)
  • 修复了组合托管 Web 视图的 WebView2 中的拖放问题。
  • 修复了应用在禁用时尝试将焦点移动到 WebView2 时崩溃的 bug。
  • 在 WebView2 弹出窗口的地址栏中删除大声朗读图标。
  • 修复了上下文菜单在 WebView2 弹出窗口中显示意外项的问题。

1.0.1418.22

发布日期：2022 年 10 月 31 日

用于 WebView2 SDK 1.0.1418.22 的 NuGet 包

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

错误修补程序

此 WebView2 SDK 版本具有与 1.0.1414-prerelease 的 Bug 修复相同的 bug 修复。

1.0.1466-prerelease

发布日期：2022 年 10 月 31 日

用于 WebView2 SDK 1.0.1466-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 添加了对创建具有指定大小的基于共享内存的缓冲区的支持：
  • 添加了对从主帧或 iframe的脚本访问共享缓冲区对象的支持：
  • 在当前顶级文档中添加了对从 JavaScript 参数运行 JavaScript 代码的支持：

1.0.1466-prerelease 的 Bug 修复

  • 修复了打印设置中的自定义标题可能错误的 bug。 (问题 #2093)
  • 以字符串的形式Base64在事件中add_ClientCertificateRequested显示AllowedCertificateAuthorities。 (仅限运行时) (问题 #2346)
  • 修复了打印设置中缺少默认页脚 URI 的 bug。 (问题 #2851)
  • 修复了生成与打印设置相关的 null 指针异常的 bug。 (仅限运行时) (问题 #2858)
  • 修复了在重定向到已配置了客户端证书身份验证的服务器以及订阅事件时 WebResourceRequested 报告导航失败的 bug。 仅 (运行时)
  • 修复了以下 AddHostObjectToScript bug：当 JavaScript 调用异步方法，然后调用同步方法时，异步方法调用可能会失败。

1.0.1370.28

发布日期：2022 年 10 月 11 日

用于 WebView2 SDK 1.0.1370.28 的 NuGet 包

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

促销

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

  • 拖放 API：

1.0.1414-prerelease

发布日期：2022 年 10 月 11 日

用于 WebView2 SDK 1.0.1414-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 添加了对打印 API 的支持：
  • 添加了对 SmartScreen API 的支持：
  • 添加了对自定义崩溃报告 API 的支持：

1.0.1414-prerelease 的 Bug 修复

  • 从下载页面删除了链接断开的三点菜单。 (仅限运行时) (问题 #2753)
  • 修复了 webView2 WinRT JS 投影工具 (wv2winrt) C++20 项目编译失败的 bug。 (问题 #2768)
  • 修复了在订阅任何事件（尤其是事件）时关闭 WebView2 时 WebView2 WinRT API 可能发生的 CoreWebView2.GetDevToolsEventReceiver 崩溃。 仅 (SDK)
  • 修复了在最小化窗口后无法关闭下载弹出窗口的 bug。 仅 (运行时)

1.0.1343.22

发布日期：2022 年 9 月 6 日

用于 WebView2 SDK 1.0.1343.22 的 NuGet 包

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

错误修补程序

此 WebView2 SDK 版本具有与 1.0.1369-prerelease 的 Bug 修复相同的 bug 修复。

1.0.1369-prerelease

发布日期：2022 年 9 月 6 日

用于 WebView2 SDK 1.0.1369-prerelease 的 NuGet 包

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

促销

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

  • 拖放 API：

1.0.1369-prerelease 的 Bug 修复

  • 修复了关闭带有 WebView2 的窗口时 WPF 应用崩溃的 bug。 (问题 #640)
  • 修复了同时生成 WebView 创建失败的 bug。 (仅限运行时) (问题 #2703)
  • 修复了打印设置纸张大小，以支持小到 0.01 英寸的尺寸。 仅 (运行时)
  • 修复了 WebView2 打印对话框每次将 “缩放 ”设置重置为 “适合可打印区域” 的 bug。 (问题 #2523)
  • 修复了 wv2winrt 工具中某些项目中未引用 WinMD 文件的 bug。

1.0.1293.44

发布日期：2022 年 8 月 8 日

用于 WebView2 SDK 1.0.1293.44 的 NuGet 包

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

促销

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

  • The Favicon API:

1.0.1340-prerelease

发布日期：2022 年 8 月 8 日

用于 WebView2 SDK 1.0.1340-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 添加了对 WebResourceRequested 辅助角色的支持，允许设置筛选器，以便接收 WebResourceRequested 服务辅助角色、共享辅助角色和不同源 iframe 的事件。
  • 添加了对自定义方案注册的支持，使 WebView2 应用能够处理 WebResourceRequested 具有指定方案的请求的事件，并能够将 WebView2 控件导航到自定义方案。

错误修补程序

  • 为开发人员添加了显式指定从中加载 WebView2Loader.dll 的路径的功能。 (问题 #767)
  • 在使用 CallDevToolsProtocolMethod时添加了有用的错误消息。 (问题 #1609)
  • 修复了在某些 .NET 应用中查找和加载 WebView2Loader.dll 的 bug。 (问题 #2372)
  • 修复了重试下载时未触发事件的 bug DownloadStarting 。 (问题 #2489)
  • 修复了路径太长时服务辅助角色缓存中的问题。 (问题 #1900)
  • 改进了 JavaScript 中的 wv2winrtIMap 和 IMapView 投影的性能。
  • 添加对用作 WebView2 父窗口的HWND_MESSAGE的支持，以支持无外设方案。 (问题 #202)
  • 改进了以管理员用户应用身份运行的处理。
  • 修复了在 UWP 应用中使用 WebView2 时的联机/脱机状态和通知。
  • 现在可以为 WebView2 启用 GDI 缩放。 WebView2 将遵循托管应用程序的 GDI 缩放设置，而无需应用执行其他工作。 (问题 #1700)
  • 修复了关闭窗口化模式的查找栏后焦点不返回到应用程序的 bug。 (问题 #1225)

1.0.1264.42

发布日期：2022 年 7 月 4 日

WebView2 SDK 1.0.1264.42 的 NuGet 包

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

促销

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

  • 添加了 ContextMenuRequestedAPI，使主机应用能够创建或修改其自己的上下文菜单。

1.0.1305-prerelease

发布日期：2022 年 7 月 4 日

用于 WebView2 SDK 1.0.1305-prerelease 的 NuGet 包

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

促销

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

  • The Favicon API:

错误修补程序

  • 修复了可能长时间挂起的问题 PrintToPdfAsync 。 (问题 #1974)
  • 修复了当 WebView2 可见时 WebView2 从应用窃取焦点的回归。 (问题 #862)

1.0.1245.22

发布日期：2022 年 6 月 14 日

用于 WebView2 SDK 1.0.1245.22 的 NuGet 包

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

没有相应的预发行版包。

促销

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

  • 服务器证书 API，提供在应用程序级别信任服务器的 TLS 证书的选项。 它会呈现页面，而不会提示用户有关 TLS 或提供取消 Web 请求的功能。

  • ClearBrowsingData API 允许开发人员在一定期限内以编程方式清除特定数据类型：

    • ClearBrowsingData
    • ClearBrowsingDataAll
    • ClearBrowsingDataInTimeRange

  • HttpStatusCode API，它为事件中的NavigationCompleted导航请求提供 HTTP 状态代码。

错误修补程序

  • 修复了屏幕键盘的问题，即通过单击 X 按钮关闭键盘后键盘不会重新出现。 还修复了当用户在 WebView2 中从一个编辑控件切换到另一个编辑控件时键盘被关闭的问题。 (问题 #460)
  • 修复了在脚本中使用代理 AddHostObjectToScript 时出现的问题。 如果调用 setHostProperty 失败，则可能收到了内部错误消息结构，而不是 JavaScript Error 对象。
  • 修复了当 WebView2 可见时 WebView2 从应用窃取焦点的回归。 (问题 #862)
  • 修复了使用大数据的事件导致内存使用率 WebResourceRequested 增加的 bug。 (问题 #2171)
  • 修复 StatusBarTextChanged 了回归。 再次使 StatusBarText API 与以前的版本兼容。 (问题 #2414)
  • 更好地支持以管理员身份运行的应用。 (问题 #2356)

1.0.1210.39

发布日期：2022 年 5 月 9 日

用于 WebView2 SDK 1.0.1210.39 的 NuGet 包

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

促销

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

1.0.1248-prerelease

发布日期：2022 年 5 月 9 日

用于 WebView2 SDK 1.0.1248-prelease 的 NuGet 包

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

常规功能

  • 通过在 NuGet 包中添加 WinRT JS 投影工具 (wv2winrt) ，向 JavaScript 添加了对 WinRT 对象投影的支持。 有关使用 WinRT JS 投影工具的说明，请参阅 从 Web 端代码调用本机端 WinRT 代码。

促销

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

  • 服务器证书 API 提供在应用程序级别信任服务器的 TLS 证书的选项，并在不提示用户有关 TLS 或提供取消 Web 请求的功能的情况下呈现页面。

  • ClearBrowsingData API 允许开发人员在一定期限内以编程方式清除特定数据类型：

    • clearBrowsingDataInTimeRange
    • clearBrowsingDataAll

错误修补程序

  • 修复了 WPF 控件 OnWindowPositionChanged 的 事件中不可避免的崩溃。 (问题 #1531)
  • 修复了在 .NET SDK 中无法正常工作的问题 CoreWebView2EnvironmentOptions.ExclusiveUserDataFolderAccess 。 (问题 #2363)
  • 修复了导致某些使用主机对象的 Office 加载项在以前正常工作的操作期间崩溃的运行时回归。 (问题 #2337)
  • 修复了在具有不同缩放的监视器之间移动时 WebView2 内容可能变得模糊的问题。
  • 修复了回归，以确保 WebView2 创建快速失败， HRESULT_FROM_WIN32(ERROR_INVALID_STATE) 而不是超时。
  • 修复了 Chromium 更改中断 WebView2 背景色的 bug。

1.0.1185.39

发布日期： 2022 年 4 月 12 日

用于 WebView2 SDK 1.0.1185.39 的 NuGet 包

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

常规功能

  • 已 ICoreWebView2Certificate 重命名为 ICoreWebView2ClientCertificate。

促销

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

1.0.1222-prerelease

发布日期： 2022 年 4 月 12 日

用于 WebView2 SDK 1.0.1222-prerelease 的 NuGet 包

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

1.0.1222-prerelease 的实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 添加了 服务器证书 API ，它提供了一个选项，用于在应用程序级别信任服务器的 TLS 证书，并在不提示用户有关 TLS 或提供取消 Web 请求的功能的情况下呈现页面。

  • 添加了 Favicon API ，它提供了一种在网站更改或设置时获取 favicon 的方法。

促销

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

错误修补程序

  • 修复了 ZoomFactor 在超出边界时将值错误地设置为 ZoomFactor 最大值的问题。
  • 修复了在具有不同缩放的监视器之间移动时 WebView2 内容可能变得模糊的问题。
  • 修复了在视觉托管模式下和 MouseEvent.movementY 始终为 0 的 bugMouseEvent.movementX。 (问题 #2220)
  • 修复了 WebView2 中密码回归导致的登录问题。 (问题 #2291)
  • 修复了用户打开新应用窗口且网页未分配导航项时出现的故障。
  • 进行了运行时更改，修复了 WinUI 2 (UWP) 中未显示自有窗口的 bug。
  • 修复了 ICoreWebView2Frame::PostWebMessage 源更新后的功能。 (问题 #2267)

1.0.1150.38

发布日期：2022 年 3 月 10 日

用于 WebView2 SDK 1.0.1150.38 的 NuGet 包

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

促销

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

1.0.1189-prerelease

发布日期：2022 年 3 月 10 日

用于 WebView2 SDK 1.0.1189-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

促销

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

错误修补程序

  • 修复了 WebView2 应用偶尔在 UWP 中卡住的 bug。
  • 修复了关闭窗口模式的 “查找 栏”后焦点未返回到应用程序的 bug。
  • 修复了单页应用中的向后/向前导航未引发事件的 bug DocumentTitleChanged 。
  • 修复了未为 Iframe 导航引发事件的 bug HistoryChanged 。

1.0.1108.44

发布日期：2022 年 2 月 6 日

用于 WebView2 SDK 1.0.1108.44 的 NuGet 包

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

促销

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

  • AdditionalAllowedFrameAncestors API，使开发人员能够提供其他允许的帧上级。

  • ProcessInfo API 提供有关 WebView2 进程和进程集合的详细信息。

  • 适用于 iframe 的新 API：

    • add_NavigationStarting
    • remove_NavigationStarting
    • add_ContentLoading
    • remove_ContentLoading
    • add_NavigationCompleted
    • remove_NavigationCompleted
    • add_DOMContentLoaded
    • remove_DOMContentLoaded
    • ExecuteScript
    • PostWebMessageAsJson
    • PostWebMessageAsString
    • add_WebMessageReceived
    • remove_WebMessageReceived

1.0.1158-prerelease

发布日期：2022 年 2 月 6 日

用于 WebView2 SDK 1.0.1158-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 添加了 状态栏 API ，用于在 webiew 显示状态消息、URL 或空字符串时提供信息。

  • 添加了 CDP API ，为开发人员提供了在 WebView2 中具有多个 DevToolsProtocol 目标的可能性。

促销

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

错误修补程序

  • 修复了导致 Visual Studio 错误列表窗口中出现错误警告的问题。 (问题 #1722)
  • 修复了打开 PDF 下载时未引发 NewWindowRequested 的 bug。
  • 解决了 WinUI 3 中不显示选择下拉列表的 bug。 (问题 #1693)
  • 添加了切换 WebView2 静音状态的功能，即使没有音频播放也是如此。

1.0.1072.54

发布日期：2022 年 1 月 13 日

用于 WebView2 SDK 1.0.1072.54 的 NuGet 包

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

促销

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

  • 媒体 API ，使开发人员能够在 WebView2 中将媒体静音/取消静音。

  • 下载定位和定位 API 可实现：

    • 更改下载对话框相对于 WebView2 边界的位置。 可以将下载对话框定位到“ 下载 ”按钮，而不是默认位置（右上角）。
    • 以编程方式打开和关闭默认下载对话框。
    • 做出更改以响应打开和关闭对话框。

1.0.1133-prerelease

发布日期：2022 年 1 月 13 日

用于 WebView2 SDK 1.0.1133-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

促销

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

错误修补程序

  • 修复了 Set-Cookies 阻止标头显示在事件中的 WebResourceResponseReceived bug。
  • 解决了弹出窗口和拥有的窗口在关闭之前会跳到其他位置而不是随应用窗口一起关闭的 bug。 此 bug 仅在很短的时间内处于活动状态。
  • 修复了关闭文件选取器对话框后的焦点问题。
  • 修复了 WebView2 可见性不随 WebView2 可见性更改页面上的“查找”UI 可见性的 bug。
  • 修复了无法找到/加载 WebView2Loader.dll的 bugGetAvailableBrowserVersionString()。 (问题 #1236)
  • 固定了未处理事件时NewWindowRequested使用 window.open 创建的新窗口的大小和位置。 (问题 #1343)
  • 修复了禁用上下文菜单时，迷你菜单仍显示在所选文本上的 bug。 此更改特定于运行时。 (问题 #1345)
  • 修复了在 WinForms 中切换应用后焦点返回到错误位置的 bug。

1.0.1083-prerelease

发布日期：2021 年 11 月 29 日

用于 WebView2 SDK 1.0.1083-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 在 WebView2 中 为 iframe 添加了以下 API：

    • PostWebMessageAsJson
    • PostWebMessageAsString
    • add_WebMessageReceived
    • remove_WebMessageReceived

  • 添加了 ProcessInfo API，以提供有关 WebView2 进程 和 进程集合的详细信息。

促销

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

  • 媒体 API ，使开发人员能够在 WebView2 中将媒体静音/取消静音。
  • 下载定位和定位 API。 此 API 可实现：
    • 更改下载对话框相对于 WebView2 边界的位置。 可以将下载对话框定位到“ 下载 ”按钮，而不是默认位置（右上角）。
    • 以编程方式打开和关闭默认下载对话框。
    • 做出更改以响应打开和关闭对话框。

错误修补程序

  • 修复了关闭文件选取器对话框后焦点问题。
  • 修复了 WebView2 在初始启动时不接收空间输入的 bug。
  • 修复了阻止 WebView2 中的单一登录的问题。
  • 解决了下载对话框未随 WPF 和 WinForms 上的窗口移动的 bug。
  • 更新了兼容的命令行检查，以防止需要对可选开关进行版本检查。
  • 修复了导致“Microsoft Edge”品牌显示在辅助功能树中的错误。

1.0.1054.31

发布日期：2021 年 11 月 29 日

用于 WebView2 SDK 1.0.1054.31 的 NuGet 包

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

错误修补程序

  • 常规可靠性修复。
  • 关闭了 v96 WebView2 运行时的控制流强制技术 (CET) 阴影堆栈功能。
  • 修复了在 .NET 单文件应用程序中启动时导致启动时间变慢的问题。 (问题 #1909)
  • 修复了 Edge 浏览器策略Microsoft错误地应用于 WebView2 而导致的崩溃。 (问题 #1860)
  • 修复了关闭包含下载对话框的弹出窗口时发生的崩溃。 (问题 #1765) & (问题 #1723)

1.0.1056-prerelease

发布日期：2021 年 10 月 29 日

用于 WebView2 SDK 1.0.1056-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 下载定位和定位 API。 此 API 可实现：
    • 更改下载对话框相对于 WebView2 边界的位置。 可以将下载对话框定位到“ 下载 ”按钮，而不是默认位置（右上角）。
    • 以编程方式打开和关闭默认下载对话框。
    • 做出更改以响应打开和关闭对话框。

错误修补程序

  • 常规可靠性改进。
  • 实际进程退出代码现在作为 中提供ExitCodeICoreWebView2ProcessFailedEventArgs2，用于COREWEBVIEW2_PROCESS_FAILED_KIND_BROWSER_PROCESS_EXITED处理进程失败。
  • 现在AdditionalBrowserArguments，在 --js-flags 中提供的 CoreWebView2EnvironmentOptions中采用开关。
  • 修复了对 name JavaScript 中主机对象的 属性的访问。 (问题 #641)
  • InvalidCastException修复了在事件循环启动之前隐式初始化 WPF 控件中的 。 (问题 #1577)

1.0.1020.30

发布日期：2021 年 10 月 25 日

用于 WebView2 SDK 1.0.1020.30 的 NuGet 包

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

促销

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

错误修补程序

  • 更新 EnsureCoreWebView2Async 为在设置 WPF 源属性时不引发异常。 (问题 #1781)
  • 修复了 WebView2 在与显示下载 UI 的多个窗互后崩溃的 bug。 (问题 #1723)

1.0.992.28

发布日期：2021 年 9 月 27 日

用于 WebView2 SDK 1.0.992.28 的 NuGet 包

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

促销

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

错误修补程序

  • 修复了缺少 WebView2 DLL (导致初始化失败) PlatformTarget 未在用户的 .NET 项目中设置的问题。 (问题 #1061)

1.0.1018-prerelease

发布日期：2021 年 9 月 20 日

用于 WebView2 SDK 1.0.1018-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

错误修补程序

  • 修复了当应用跨监视器且监视器缩放发生更改时 WebView2 停止呈现的 bug。
  • 修复了在打开多个下载窗口时关闭下载 UI 时 WebView2 崩溃的 bug。 (问题 #1723)
  • 修复了未在用户的 .NET 项目中设置 PlatformTarget 时出现生成/初始化错误。 (问题 #730 和 问题 #1548)

1.0.1010-prerelease

发布日期： 2021 年 9 月 14 日

用于 WebView2 SDK 1.0.1010-prerelease 的 NuGet 包

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

常规功能

  • WebView2 性能改进。
  • 可靠性修复。 (问题 #1605 和 问题 #1678)
  • 添加了在启动期间和主机应用在前台时的性能改进。

实验性 API

此预发布 SDK 中添加了以下实验性 API。

促销

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

  • IsSwipeNavigationEnabled
  • BrowserProcessExited
  • OpenBrowserTaskManager

错误修补程序

  • 改进了在 JavaScript 代码中捕获主机对象异常的方式。
  • 已将 WebView2 图标替换为 DevTools 窗口中的通用图标。
  • 使用 时 MediaDevices.getDisplayMedia() 打开选项卡屏幕共享选项。 (问题 #1566)
  • 修复了未选择正确证书时客户端证书 API 中的 bug。 这是运行时更改。 (问题 #1666)
  • 修复了同一父域的新窗口中不可用的 bug window.chrome.webview 。 此更改特定于运行时。 (问题 #1144)
  • 修复了下拉菜单或列表显示在具有焦点的窗口后面的错误。 (问题 #411)
  • 修复了使用 put_IsVisible(false)时的焦点问题。 (问题 #238)
  • 修复了应用于 SetVirtualHostNameToFolderMapping 弹出窗口的 bug。
  • 修复了将对象返回为 IUnknown的 bugIDispatch。

1.0.961.33

发布日期：2021 年 9 月 8 日

用于 WebView2 SDK 1.0.961.33 的 NuGet 包

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

促销

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

错误修补程序

  • 修复了 ERR_SSL_CLIENT_AUTH_CERT_NEEDED 导致错误的 bug。 这是运行时更改。
  • 修复了无法使用 关闭AreBrowserAcceleratorKeysEnabled特殊浏览器键（如“刷新”、“开始”、“后退”等）的 bug。 此更改特定于运行时。
  • 修复了不呈现透明背景色的 bug。
  • 修复了加载 WebView2 时导致白色闪烁的 bug。
  • 修复了 WebView2 .NET 控件中 WebView2 窗口在后台创建时为空白的 bug。 (问题 #1077)
  • 修复了用户导航到或新窗口显示 about:blank 页面时设置未更新的 bug。 这是运行时更改。

1.0.955-prerelease

发布日期：2021 年 7 月 26 日

用于 WebView2 SDK 1.0.955-prerelease 的 NuGet 包

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

常规功能

  • WebView2 性能改进。
  • 添加了 Windows (ETW 的部分事件跟踪) 支持。
  • 从 edge://history中删除了Microsoft品牌。
  • 新的默认下载 UI。

实验性 API

促销

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

错误修补程序

  • 修复了破坏 和 edge://history 页的 edge://downloads bug。 此更改特定于运行时。
  • 修复了 bug 以提高 WebView2Loader.dll 的可靠性。
  • 修复了事件处理程序在 NewWindowRequested 处理使用 target=_blank的链接时启动两个窗口的 bug。
  • 修复了 WebView2 视觉对象托管在启动前闪烁的 bug。
  • 修复了在使用 add_NewWindowRequested创建的 WebView2 控件上不起作用时的 add_WebResourceRequested bug。 (问题 #616)
  • 允许主机应用在不同的应用程序上设置前台，以响应事件，包括 NavigationStarting、 AddHostObjectToScript 方法、 WebMessageReceived和 NewWindowRequested。 (问题 #1092)
  • 修复 bug 以触发 PermissionRequested 麦克风的事件。 此更改是特定于运行时的. (问题 #1462)
  • 修复了几次成功运行后被阻止的 ExecuteScriptAsync bug。 此更改特定于运行时。 (问题 #1348)
  • 修复了阻止在 中使用 ResultFilePath 非 ASCII 文件名的 DownloadStartingEventArgsbug。 (问题 #1428)
  • 修复了默认弹出窗口上的标题栏未完全显示的问题。 此更改特定于运行时。 (问题 #1016)

.NET

错误修补程序
  • 修复了 WebView2 .NET API 参考文档中导致仅显示第一个异常的问题。
  • .NET Core 库现在以发布模式生成。 若要调试，请确保清除“ 仅我的代码 ”复选框。
  • 修复了在具有子窗体的窗体上导致 WebView2 崩溃的 bug。 打开页栏中的“查找”的子窗体导致 WebView2 在关闭子窗体时崩溃。 (问题 #1097)

1.0.902.49

发布日期：2021 年 7 月 26 日

用于 WebView2 SDK 1.0.902.49 的 NuGet 包

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

促销

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

错误修补程序

  • 修复了破坏 IsBuiltInErrorPageEnabled 属性的 bug，该 bug 关闭了导航失败或呈现进程失败时显示的错误页。 此更改特定于运行时。 (问题 #634)
  • 修复了 WebView2 控件将焦点从用户焦点移开的问题。
  • 修复了在子窗口上不起作用时的 AddScriptToExecuteOnDocumentCreated bug。 (问题 #935)
  • 修复了导致非活动选项卡自动丢弃的 bug。 (问题 #637)
  • 修复了导航事件被另一个导航事件中断导致事件的导航 ID 不正确时出现的 NavigationCompleted bug。 (问题 #1142)

1.0.902-prerelease

发布日期：2021 年 6 月 1 日

用于 WebView2 SDK 1.0.902-prerelease 的 NuGet 包

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

常规功能

  • 改进了 WebView2 启动性能和磁盘占用情况。

实验性 API

此预发布 SDK 中添加了以下实验性 API。

  • 添加了 IsSwipeNavigationEnabled 属性，以启用或禁用最终用户在支持触摸输入的设备上使用轻扫手势在 WebView2 中导航的功能。

  • 添加了 BrowserProcessExited 事件。

  • 添加了 add_ClientCertificateRequested API。 它允许在需要时显示客户端证书对话框提示，并允许访问所需的元数据来替换默认的客户端证书对话框提示。

促销

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

错误修补程序

  • 修复了鼠标左键单击不关闭上下文菜单的 bug。 此更改特定于运行时。
  • 修复了当共享同一用户数据文件夹的应用的 exe 文件的版本信息不一致时，WebView2 创建失败的 bug。
  • 修复了一个 bug，Home即 、 和 Back 等Refresh特殊浏览器键不能被 AreBrowserAcceleratorKeysEnabled禁用。 此更改特定于运行时。
  • 修复了 WebView2 .NET 控件中的 bug，其中 WebView2 窗口在后台创建时为空。 (问题 #1077)
  • 通过按 Enter 或 Esc 关闭文件选取器对话框不再使用 WebView2 控件崩溃 WPF 应用程序。 (问题 #1099)
  • 修复了附加事件处理程序时 WebResourceRequestedAllowSingleSignOnUsingOSPrimaryAccount 无法与 WebView2 正常工作的 bug。 此更改特定于运行时。 (问题 #1183)
  • 下载文件不再破坏 WebView2 DefaultBackgroundColor 透明度。 此更改特定于运行时。 (问题 #1108)
  • 删除了包含Microsoft品牌打造的屏幕共享媒体选取器消息。 (问题 #940)
  • 修复了 WebView2 WinForm 控件中隐藏父窗体不会隐藏 WebView2 控件的 bug。 (问题 #828 和 问题 #1079)
  • 向 WebView2 的 WPF 窗口添加了静态WS_CLIPCHILDREN样式。 (问题 #1013) 。
  • 修复了右键单击链接导致 WebView2 主机应用崩溃的 bug。 此更改特定于运行时。
  • 修复了在迁移到较新的 Edge WebView2 运行时版本时可能会使主机应用进程崩溃的可靠性 bug。
  • 弃用：正式弃用了适用于 Windows 7 的 DefaultBackgroundColor API。

.NET

错误修补程序
  • 修复了 WebView2 WinForm 控件中的 bug，即在释放父窗口后 WebView2 窗口可见性未正确更新。 (问题 #1282 和 问题 #828)
  • 修复了 WebView2 WPF 控件中的 Bug：WPF OneWay 绑定模式下的源属性绑定无法正常工作。 (问题 #619 和 问题 #608)

1.0.864.35

发布日期：2021 年 5 月 31 日

用于 WebView2 SDK 1.0.864.35 的 NuGet 包

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

错误修补程序

  • 修复了在迁移到较新的 Edge WebView2 运行时版本时可能会使主机应用进程崩溃的可靠性 bug。
  • 修复了在某些情况下阻止内存清除的 bug。 此更改特定于运行时。
  • 修复了 818 SDK 发布包中项目找不到该文件的错误 WebView2.h 。 (问题 #1209) 。
  • 修复了导致某些具有二进制体的请求删除 WebResourceRequested 事件的 bug。
  • 改进 NewWindowRequested 文档。 (问题 #448) 。

促销

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

.NET

错误修补程序
  • 修复了 WebView2 .NET 控件中循环访问 CoreWebView2WebResourceRequest 标头集合时缺少第一个标头的 bug。 (问题 #1123) 。

1.0.865-prerelease

发布日期：2021 年 4 月 26 日

用于 WebView2 SDK 1.0.865-prerelease 的 NuGet 包

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

实验性 API

此预发布 SDK 中添加了以下实验性 API。

错误修补程序

  • 修复了 WebView2 中具有POST二进制数据的消息的处理程序Chromium DevTools Protocol。
  • 关闭了 OpenSaveAsAwareness 下载 UI，因为它包含指向 edge://settings的链接。 (问题 #1120) 。
  • 从屏幕共享对话框中删除了品牌。 (问题 #940) 。
  • 修复了 SetWindowDisplayAffinity 函数在 WebView2 应用中停止屏幕捕获时中断 WebView2 的 bug。 (问题 #841) 。
  • 修复了合成托管的 bug，其中鼠标输入在将任何笔输入发送到 WebView2 时停止工作。
  • 修复了任何笔输入后鼠标输入中断的 bug。 此更改特定于运行时。

.NET

实验性 API

此预发行版 SDK 中添加了以下用于 .NET 的实验 API。

  • 向 WPF 工具箱添加了 WebView2 设计器工具。 (问题 #210) 。

  • 在 .NET 设计器模式下添加了 WebView2 UI 元素。

错误修补程序
  • 通过将每个说明包装在更详细的 .NET 异常中，改进了 COM 异常说明。 (问题 #338) 。 此更改特定于运行时。
  • 修复了在 Visual Studio Tools for Office Microsoft选择 “Tab” 切换焦点导致 WebView2 控件崩溃时引发的 bug。 (问题 #589 和 问题 #933) 。 此更改特定于运行时。
  • 改进了 .NET Framework 加载程序级别，以增强可靠性。 (问题 #946)
  • 修复了在完成第一个导航之前尝试刷新时导致崩溃的 bug。 (问题 #1011)
  • 修复了初始化，以便在 期间 CoreWebView2InitializationCompleted进行导航。 (问题 #1050)
  • 改进了 .NET 浏览器进程崩溃错误处理。 现在可以在处理 ProcessFailed 事件后重新创建控件，而不会发生崩溃。 (问题 #996)

1.0.818.41

发布日期：2021 年 4 月 21 日

用于 WebView2 SDK 1.0.818.41 的 NuGet 包

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

功能

  • 扩展了 ProcessFailed 事件。 它现在为非呈现器子进程和帧呈现器引发。
  • 添加了 iframe 对 的 AddScriptToExecuteOnDocumentCreated元素支持。
  • 改进了 WebView2 代码，以更灵活地应对 .exe 格式不正确的版本信息的应用程序文件。 (问题 #850) 。
  • 从 WebView2 浏览器进程命令行中删除 --winhttp-proxy-resolver ，并打开 WebView2 的其他代理命令行选项。

1.0.824-prerelease

发布日期：2021 年 3 月 8 日

用于 WebView2 SDK 1.0.824-prerelease 的 NuGet 包

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

功能

  • 扩展了 ProcessFailed 事件。 它现在为非呈现器子进程和帧呈现器引发。
  • 添加了实验 性 AreBrowserAcceleratorKeysEnabled 设置。 可以阻止浏览器响应与导航、打印、保存和其他特定于浏览器的功能相关的键盘快捷方式。
  • 添加了 iframe 对 的 AddScriptToExecuteOnDocumentCreated元素支持。

促销

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

错误修补程序

  • 扩展了支持的C++和 .NET 项目类型，例如 MFC 和 ATL。 (问题 #506、 问题 #669 和 问题 #851) 。
  • 修复了 Evergreen WebView2 运行时泄漏入站防火墙条目的 bug。
  • 修复了事件期间 WebResourceRequested 响应的设置。 (问题 #568) 。
  • 修复了导航到 导致 edge:// 浏览器进程退出的 bug。 (问题 #604) 。
  • 修复了在可视化托管模式下将 WebView2 限制为屏幕大小的 bug。

1.0.774.44

发布日期：2021 年 3 月 8 日

用于 WebView2 SDK 1.0.774.44 的 NuGet 包

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

功能

  • 在 WebView2 中关闭了各种Microsoft Edge 浏览器服务。
  • 视觉对象托管 API 现已正式发布。

促销

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

错误修补程序

  • 修复了在可视化托管模式下将 WebView2 限制为屏幕大小的 bug。

1.0.790-prerelease

发布日期：2021 年 2 月 10 日

用于 WebView2 SDK 1.0.790-prerelease 的 NuGet 包

此 WebView2 SDK 的预发行版需要Microsoft Edge 版本 86.0.616.0 或更高版本。

中断性变更

重要

中断性变更：已弃用 WebView2 预发行版包 1.0.781。 停止使用包 1.0.781 进行开发。

重要

WebView2 预发行版包 0.9.430 已弃用，并随下一个版本一起删除。 如果 WebView2 应用使用该包，则 WebView2 团队建议迁移到较新的包。

功能

促销

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

错误修补程序

  • 已关闭 WebView2 中的Microsoft Edge 购物功能。
  • 在 为 时AreDefaultContextMenusEnabledfalse关闭了 PDF 查看器中的上下文菜单。 (问题 #605) 。
  • 修复了 E_NOINTERFACE 查询 ICoreWebView2 时返回的 ICoreWebView2Experimentalbug。 (问题 #691) 。
  • 修复了当 设置为 false时CoreWebView2NavigationStartingEventArgs.Cancel允许使用格式不正确的 URI 进行导航的 bug。 (问题 #400) 。
  • 修复了在弹出窗口上阻止的 window.print() bug，该窗口的事件处理程序附加到 NewWindowRequested 事件。 (问题 #409) 。
  • 修复了在不同监视器之间移动应用时的动态 DPI 问题。 (问题 #58)
  • HRESULT改进了 ICoreWebView2WebResourceResponseViewGetContentCompletedHandler：：Invoke 传递的实例。
  • 已关闭自动填充管理按钮。 (问题 #585) 。
  • 修复了在多个窗口中托管时运行时 WebView2.Dispose Visual Studio 崩溃的问题。 (问题 #816) 和 问题 #442) 。
  • 修复了在 Visual Studio 工具箱中显示 WebView2 控件的 bug。 (问题 #210) 。
  • 减少了 CPU 使用率过高的问题。 (问题 #878) 。
  • 修复了已弃用的 1.0.781-prerelease 包的问题。 (问题 #875 和 问题 #878) 。

.NET

错误修补程序
  • 修复了使用 WPF SDK 的 WebView2 应用崩溃的 bug。 按 F4 关闭窗口时发生崩溃。 (问题 #399) 。
  • WebView2 初始化屏幕现在是透明的，而不是灰色的。 (问题 #196) 。

1.0.705.50

发布日期：2021 年 1 月 25 日

用于 WebView2 SDK 1.0.705.50 的 NuGet 包

此版本的 WebView2 SDK 需要 WebView2 运行时版本 86.0.616.0 或更高版本。

促销

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

1.0.721-prerelease

发布日期：2020 年 12 月 8 日

用于 WebView2 SDK 1.0.721-prerelease 的 NuGet 包

此 WebView2 SDK 的预发行版需要Microsoft Edge 版本 86.0.616.0 或更高版本。

中断性变更

重要

中断性变更：WebView2 预发布包 1.0.707 和包 0.9.628 已弃用。 停止使用包 1.0.707 和包 0.9.628 进行开发。

功能

  • 添加了 WebView2 组策略。 有关最佳做法，请参阅 WebView2 的组策略。

  • 重要

    中断性变更：已弃用旧的注册表位置。

    {Root}\Software\Policies\Microsoft\EmbeddedBrowserWebView\LoaderOverride\{AppId}

  • 添加了对 WebView2 中的 拖放 支持。

  • 添加了用于处理 DPI 支持的 API。

    • 添加了 RasterizationScale 属性，用于更改 WebView2 内容和 UI 弹出窗口的 DPI 比例，以及关联的 RasterizationScaleChanged 事件。
    • 添加了 ShouldDetectMonitorScaleChanges 属性，以便根据需要自动更新 RasterizationScale 属性。
    • 添加了 BoundsMode 属性 ，以指定边界是逻辑像素并允许 WebView2 用于 RasterizationScale WebView2 像素显示，WebView2 将 RasterizationScale 与 一起使用 Bounds 以获取物理大小。

  • 更新 NewWindowRequested 了处理 Ctrl+单击 和 Shift+单击的事件。 (问题 #168 和 问题 #371) 。

促销

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

.NET

功能
错误修补程序

1.0.664.37

发布日期：2020 年 11 月 20 日

用于 WebView2 SDK 1.0.664.37 的 NuGet 包

此版本的 WebView2 SDK 需要 WebView2 运行时版本 86.0.616.0 或更高版本。

正式发布版

重要

公告：.NET WPF/WinForms WebView2 SDK 现已正式发布 (GA) 。 从此版本开始，发布 SDK 向前兼容。 有关详细信息，请参阅 GA 公告博客文章。

功能

  • .NET WPF/WinForms WebView2 现已正式发布 (GA) 。
  • 固定分发 (自带) 模式已进入正式版。

.NET

错误修补程序

1.0.674-prerelease

发布日期：2020 年 10 月 19 日

用于 WebView2 SDK 1.0.674-prerelease 的 NuGet 包

此 WebView2 SDK 的预发行版需要 WebView2 运行时版本 86.0.616.0 或更高版本。

常规功能

.NET

1.0.622.22

发布日期：2020 年 10 月 19 日

用于 WebView2 SDK 1.0.622.22 的 NuGet 包

此版本的 WebView2 SDK 需要 WebView2 运行时版本 86.0.616.0 或更高版本。

重要

公告：Win32 C/C++ WebView2 现已正式发布 (GA) 。 从此版本开始，发布 SDK 可向前兼容。 请参阅 GA 公告博客文章。

  • Evergreen WebView2 运行时和安装程序已正式发布。 Microsoft Edge WebView2 上提供了引导程序、引导程序下行链接和 Evergreen WebView2 运行时的独立安装程序。 WebView2Samples 存储库中还提供了安装工作流的示例代码。

有关运行时、Evergreen 分发和固定版本分发的详细信息，请参阅 分发应用和 WebView2 运行时。

0.9.622.11

发布日期：2020 年 9 月 10 日

用于 WebView2 SDK 0.9.622.11 的 NuGet 包

此版本的 WebView2 SDK 需要 WebView2 运行时版本 86.0.616.0 或更高版本。

0.9.579

发布日期：2020 年 7 月 20 日

用于 WebView2 SDK 0.9.579 的 NuGet 包

此版本的 WebView2 SDK 需要Microsoft Edge 版本 86.0.579.0 或更高版本。

所有平台

  • 重要

    公告：Evergreen WebView2 运行时和安装程序已发布预览版。 请参阅 分发应用和 WebView2 运行时。

  • 重要

    公告：下一个 SDK 发布后，不再支持以下 WebView2 SDK 版本：

    WebView2 SDK 版本在 nuget.org 上也标记为已弃用。WebView2 建议随时了解最新版本的 WebView2。

  • 添加了 WebView2 工作线程改进。 (问题 #318) 。

  • 已关闭 WebView2 中的弹出窗口阻止程序。 请参阅 事件中的 NewWindowRequestedIsUserInitiated 属性。

  • 确保为 about:blank运行 WebView2 导航启动事件。 现在，NavigationStarting所有导航都运行事件，但不支持和忽略 元素的 iframe 或 srcdoc 取消about:blank。

  • 阻止了 WebView2 中的某些 edge:// URI 方案。

  • 在 WebView2 环境选项上添加了试验性 IsSingleSignOnUsingOSPrimaryAccountEnabled 属性，以启用 WebView2 的条件访问。

  • 添加了试验 性 WebResourceResponseReceived 事件，该事件在 WebView2 接收并处理来自 WebResource 请求的响应后运行。 身份验证标头（如果有）包含在响应对象中。

.NET

  • 改进了 WPF 焦点处理。 (问题 #185) 。
  • 在 WPF Webview2 控制器上添加了 ZoomFactor 属性。

0.9.538

发布日期：2020 年 6 月 8 日

用于 WebView2 SDK 0.9.538 的 NuGet 包

此版本的 WebView2 SDK 需要Microsoft Edge 版本 85.0.538.0 或更高版本。

所有平台

  • 放弃对 WebView2 SDK 版本 0.8.149 的支持。 WebView2 建议随时了解最新版本的 WebView2。
  • 更新了组策略，以考虑何时修改 Microsoft Edge 浏览器的配置文件路径 (#179) 。

Win32 C/C++

.NET (0.9.538 预发行版)

0.9.515-prerelease

发布日期：2020 年 5 月 14 日

用于 WebView2 SDK 0.9.515-prerelease 的 NuGet 包

此 WebView2 SDK 的预发行版需要Microsoft Edge 版本 84.0.515.0 或更高版本。

  • 重要

    公告：WebView2 现在支持 预发行版包中的 .NET Framework 4.6.2 或更高版本和 .NET Core 3.0 或更高版本上的 Windows 窗体和 WPF。

  • 有关生成 WPF 应用的详细信息，请参阅 WPF 应用中的 WebView2 入门 和 WPF 特定 API 的 WebView2 WPF 参考 。

  • 有关生成 Windows 窗体应用的详细信息，请参阅 WinForms 应用中的 WebView2 入门 和适用于 Windows 窗体的 WebView2 Windows 窗体参考 特定 API。

  • 有关 CoreWebView2 API 的详细信息，请参阅 .NET 参考。

  • 警告

    已知问题：WebView2 团队知道预发行版中的一些问题正在将来的版本中解决。

    • DPI 感知：WPF 的 WebView2 当前不是 DPI 感知。 在高 DPI 监视器上初始化 WebView2 时，存在一个已知问题，即 WebView2 控件首先初始化为窗口的一小部分，直到调整窗口大小。
    • WPF 设计器：目前不支持 WPF 设计器。 通过在文本编辑器中直接修改相应的 XAML，在应用中添加 WebView2 控件。

0.9.488

发布日期：2020 年 4 月 20 日

用于 WebView2 SDK 0.9.488 的 NuGet 包

此版本的 WebView2 SDK 需要Microsoft Edge 版本 84.0.488.0 或更高版本。

0.9.430

用于 WebView2 SDK 0.9.430 的 NuGet 包

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 82.0.430.0 或更高版本。

WebView2 SDK 是官方的 Win32 C++ Beta 版本，其中包含来自反馈的多个功能请求。 WebView2 团队尝试使用中断性变更来限制发布的数量。 随着正式版的临近，Beta 版中将合并了一些重大中断性变更。

  • 重要

    中断性变更：随着最终版本的临近，WebView2 团队将前缀IWebView2WebViewICoreWebView2重命名为，以确保 WebView2 API 符合 Windows API 命名约定。 此外，为了从 UI 框架利用 WebView2 SDK，WebView2 团队分为 ICoreWebView2ICoreWebView2 和 ICoreWebView2Host。 ICoreWebView2Host 支持调整大小、显示和隐藏、聚焦以及与开窗和合成相关的其他功能。 ICoreWebView2 支持所有其他 WebView2 功能。 若要了解有关合并更改的详细信息，请参阅 WebView2 APISample 项目中的 WebView2 拉取请求。

  • 重要

    中断性变更：将 DocumentStateChanged 拆分为三个组件： SourceChanged、 ContentLoading 和 HistoryChanged。 现在，当源 URL 更改时， SourceChanged 将运行事件。 更改历史记录状态时，将 HistoryChanged 运行事件。 加载新文档时，事件 ContentLoading 在初始脚本之前运行。

  • 添加了对 ARM64 体系结构的支持。

  • 添加了对触摸屏设备的软输入面板 (SIP) 支持。

  • 添加了对 Windows Server 2008 R2、Windows Server 2012、Windows Server 2012 R2 和 Windows Server 2016 的支持。

  • 为状态栏添加了 NotifyParentWindowPositionChanged ，以在窗口模式中跟随窗口。 此外，在无窗口模式下实现更改，以便辅助功能正常工作。

  • 添加了 AreRemoteObjectsAllowed 设置，以全局控制网页是否可以由任何远程对象访问。 默认情况下， AreRemoteObjectsAllowed 处于打开状态，因此可从网页访问 AddRemoteObject 添加的远程对象。 关闭 后 AreRemoteObjectsAllowed ，无法从网页访问对象。 更改将应用于下一个导航事件。

  • 添加了 IsZoomControlEnabled 设置，以防止用户使用 Ctrl 和 Ctrl+-++ (或 Ctrl+ 鼠标滚轮) 影响 WebView2 控件的缩放。 关闭设置时，仍可使用 put_ZoomFactor 来设置缩放。

  • 已将 ZoomFactor 更改为仅适用于当前 WebView2 控件。 对当前 WebView2 控件的缩放更改不会影响使用同一原点网站导航到的其他 WebView。 请参阅 get_ZoomFactor。

  • Hid ZoomView UI for WebView2 控件 (#95) 。

  • 添加了 SetBoundsAndZoomFactor。 现在，可以同时设置 WebView2 控件的缩放因子和边界。

  • 添加了 WindowCloseRequested 事件。 请参阅 add_WindowCloseRequested (#119) 。

  • 添加了对 beforeunload JavaScript 对话框事件的对话框类型的支持，并添加了 CORE_WEBVIEW2_SCRIPT_DIALOG_KIND_BEFOREUNLOAD 枚举项。

  • 向 HttpRequestHeaders 添加了 GetHeaders ，向 HttpResponseHeaders 添加了 GetHeader ，并向 HttpHeadersCollectionIterator 添加了 get_HasCurrentHeader 属性。

  • 重要

    中断性变更：修改 DevToolsProtocolEventReceived 的行为。 现在，可以为特定的 DevTools 协议事件创建 DevToolsProtocolEventReceiver ，并使用 add_DevToolsProtocolEventReceived/remove_DevToolsProtocolEventReceived订阅/取消订阅此类事件。

  • 重要

    中断性变更：将get_WebMessageAsString属性更改为 WebMessageReceivedEventArgsTryGetWebMessageAsString 方法。

  • 重要

    中断性变更：将 Handle 方法更改为AcceleratorKeyPressedEventArgsget_Handled属性。

0.8.355

发布日期：2019 年 12 月 9 日

用于 WebView2 SDK 0.8.355 的 NuGet 包

此版本的 WebView2 SDK 需要Microsoft Edge 版本 80.0.355.0 或更高版本。

0.8.314

发布日期：2019 年 10 月 28 日

用于 WebView2 SDK 0.8.314 的 NuGet 包

此版本的 WebView2 SDK 需要Microsoft Edge 版本 80.0.314.0 或更高版本。

更改

  • 添加了对 Windows 7、Windows 8 和 Windows 8.1 的支持。 请参阅 Microsoft Edge WebView2 简介中的支持平台。

  • 添加了对 WebView2 的 Visual Studio 和 Visual Studio Code 调试支持。 现在，直接从 IDE 在 WebView2 中调试脚本。 请参阅 如何使用 WebView2 控件进行开发时进行调试。

  • 为 WebView2 中的运行脚本添加了 Native Object Injection ，以便从应用的 Win32 组件访问 IDispatch 对象并访问 IDispatch 对象的属性。 请参阅 AddRemoteObject (#17) 。

  • 添加了 AcceleratorKeyPressed 事件。 请参阅 add_AcceleratorKeyPressed (#57) 。

  • 已关闭 Context Menus。 请参阅 put_AreDefaultContextMenusEnabled (#57) 。

  • 更新了 DPI Awareness。 现在，WebView2 控件的 DPI 感知与主机应用的 DPI 感知相同。

    注意

    如果使用与原始 WebView2 控件实例不同的 DPI 感知启动另一个混合应用，则如果 user data folder 是相同的 (#1) ，则不会启动新的 WebView2 控件实例。

  • 更新 Notification Change Behavior 后，WebView2 会自动拒绝 WebView2 控件中托管的 Web 内容提示的通知权限请求。

0.8.270

发布日期：2019 年 9 月 10 日

用于 WebView2 SDK 0.8.270 的 NuGet 包

此版本的 WebView2 SDK 需要Microsoft Edge 版本 78.0.270.0 或更高版本。

更改

  • 添加了 DocumentTitleChanged 事件以指示文档标题更改 (问题 #27) 。

  • 添加了 GetWebView2BrowserVersionInfo API (问题 #18) 。

  • 添加了 NewWindowRequested 事件。

  • 更新 CreateWebView2EnvironmentWithDetails 了函数以删除 releaseChannelPreference。 有关函数 CreateWebView2EnvironmentWithDetails 的详细信息，请参阅 CreateWebView2EnvironmentWithDetails。 仍支持注册表和环境变量替代。 除非重写，否则使用默认通道首选项。

    在通道搜索期间，WebView2 团队会跳过任何与 WebView2 SDK 不兼容的先前频道版本。

    WebView2 团队选择更稳定的通道，以确保最终用户的行为最一致。 使用最新的 Canary 内部版本进行测试时，应在启动应用之前创建一个脚本来 WEBVIEW2_RELEASE_CHANNEL_PREFERENCE 将环境变量 1 设置为 。 请参阅 测试即将推出的 API 和功能。

  • 更新了函数， CreateWebView2EnvironmentWithDetails 其中包含用于在未指定时选择的 userDataFolder 逻辑。 有关函数 CreateWebView2EnvironmentWithDetails 的详细信息，请参阅 CreateWebView2EnvironmentWithDetails。 如果以前使用了默认 userDataFolder 位置，则切换到新 SDK 时，将重置默认值 userDataFolder (设置为主机代码目录中的新位置) 并且状态也会重置。 如果主机进程没有写入指定目录的权限，则 CreateWebView2EnvironmentWithDetails 函数可能会失败。 可以将数据从旧 user data folder 目录复制到新目录。

0.8.230

发布日期：2019 年 7 月 29 日

用于 WebView2 SDK 0.8.230 的 NuGet 包

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 77.0.230.0 或更高版本。

更改

  • 添加了 Stop API 以停止所有导航和挂起的资源提取 (问题 #28) 。
  • 向 NuGet 包添加了 .tlb 文件 (问题 #22) 。
  • 向 NuGet 包中的安装程序列表添加了 .NET 项目 (问题 #32) 。

0.8.190

发布日期：2019 年 6 月 17 日

用于 WebView2 SDK 0.8.190 的 NuGet 包

此版本的 WebView2 SDK 需要Microsoft Edge 版本 77.0.190.0 或更高版本。

  • 添加了 get_AreDevToolsEnabled/put_AreDevToolsEnabled 以控制用户是否可以打开 DevTools (问题 #16) 。
  • 添加了 get_IsStatusBarEnabled/put_IsStatusBarEnabled 以控制是否显示状态栏 (问题 #19) 。
  • 添加了get_CanGoBackget_CanGoForwardGoForward/GoBack//用于在导航历史记录中后退和前进。
  • 添加了 HTTP 标头类型 (IWebView2HttpHeadersCollectionIterator//IWebView2HttpRequestHeadersIWebView2HttpRequestHeaders) ，用于在 WebView2 中查看和修改 HTTP 标头。
  • 在 64 位计算机上添加了 32 位 WebView2 支持 (问题 #13) 。
  • 已将 WebView2 IDL 添加到 SDK (问题 #14) 。
  • 添加了 lib 以支持 IID\_\* 接口 ID 对象 (问题 #12) 。
  • 在 SDK 中向 NuGet TARGET 文件添加了包含路径、链接和自动复制 DLL 文件。
  • 在脚本中启用请求 window.open() 。

0.8.149

发布日期：2019 年 5 月 6 日

用于 WebView2 SDK 0.8.149 的 NuGet 包

此版本的 WebView2 SDK 需要 Microsoft Edge 版本 76.0.149.0 或更高版本。

初始开发人员预览版。

另请参阅