WebView2 SDK 的存档发行说明
这些发行说明提供有关旧版 WebView2 版本 SDK 和 WebView2 预发布 SDK 中包含的新增功能和 bug 修复的信息。
1.0.2592.51
发布日期:2024 年 6 月 19 日
用于 WebView2 SDK 1.0.2592.51 的 NuGet 包
为了完全实现 API 兼容性,此 WebView2 SDK 版本需要 WebView2 运行时版本 126.0.2592.51 或更高版本。
促销
此发布 SDK 中没有其他 API 已提升到稳定版并已添加。
错误修补程序
仅限运行时
BreakoutBoxPreferCaptureTimestampInVideoFrame
为 WebView2TextureStream
禁用。修复了仅针对第一次
window.close()
调用触发事件的回归WindowCloseRequested
。修复了以下回归:WinRT JavaScript 投影中的类型化数组无法像主机一样
IDispatch
进行处理。修复了自动填充弹出窗口立即消除并导致焦点更改的 bug。
修复了由于 导致 WebView2 加载失败的
AppPolicyGetWindowingModel
bug。 (问题 #4591)
1.0.2646-prerelease
发布日期:2024 年 6 月 19 日
用于 WebView2 SDK 1.0.2646-prerelease 的 NuGet 包
为了完全实现 API 兼容性,此预发布版本的 WebView2 SDK 需要Microsoft Edge 版本 128.0.2646.0 或更高版本随附的 WebView2 运行时。
常规功能
- 添加了对 C#/WinRT .NET 6+ 的支持。
实验性功能
- 引入了功能标志
msWebView2EnableDownloadContentInWebResourceResponseReceived
,这是一个实验性功能, (而不是稳定功能) 。 启用此标志后,这允许在 中WebResourceResponseReceived
提供成为下载的导航的响应。
实验性 API
此预发布 SDK 中添加了以下实验性 API。
- 添加了一个新
SaveFileSecurityCheckStarting
事件。 开发人员可以在此事件上注册处理程序,以获取文件路径、文件扩展名和文档源 URI 信息。 然后,可以应用自己的规则来执行如下操作:- 允许保存文件,而不显示有关文件类型策略的默认安全警告 UI。
- 取消保存。
- 创建自己的 UI 来管理运行时文件类型策略。
CoreWebView2
类:CoreWebView2SaveFileSecurityCheckStartingEventArgs 类
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave 属性
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri 属性
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension 属性
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath 属性
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy 属性
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral 方法
- 添加了一个新
ScreenCaptureStarting
事件。 每当与 (或其任何后代 iframe 相对应的CoreWebView2Frame
WebView2 和/或 iframe) 请求在显示 UI 之前使用屏幕捕获 API 的权限时,都会引发此事件。 作为开发人员,你可以选择阻止显示 UI,或允许显示 UI。
CoreWebView2
类:CoreWebView2Frame
类:CoreWebView2ScreenCaptureStartingEventArgs
类:
- 向 .NET 类添加了一个新
GetComICoreWebView2
方法CoreWebView2
,可用于在 .NET 和 COM 之间转换CoreWebView2
。 添加了一个新的 WinRT 接口,可用于在 WinRT 和 COM 之间转换CoreWebView2
。 这样,就可以在以不同语言编写的库之间进行互操作。
-
CoreWebView2
类:
促销
在此预发行版 SDK 中,以下 API 已从实验性提升为稳定 API。
- 更新了 WebMessageObjects API,允许将 DOM 对象注入到通过应用构造的 WebView2 内容中,并通过
CoreWebView2.PostWebMessage
API 在其他方向上构造。 添加了一个新的 Web 对象类型来表示文件系统句柄,该句柄可以发布到 Web 内容,以便为其提供文件系统访问权限。
CoreWebView2
类:CoreWebView2Environment
类:CoreWebView2FileSystemHandle
类:CoreWebView2FileSystemHandleKind 枚举
File
Directory
CoreWebView2FileSystemHandlePermission 枚举
ReadOnly
ReadWrite
错误修补程序
仅限运行时
- 修复了视觉对象托管的自有窗口激活逻辑中的 bug。
1.0.2535.41
发布日期:2024 年 5 月 28 日
用于 WebView2 SDK 1.0.2535.41 的 NuGet 包
为了完全实现 API 兼容性,此 WebView2 SDK 版本需要 WebView2 运行时版本 125.0.2535.41 或更高版本。
促销
以下 API 已提升为稳定版,现已包含在此发布 SDK 中。
- 支持 Fluent 样式覆盖滚动条。
CoreWebView2EnvironmentOptions
类:-
Default
FluentOverlay
错误修补程序
仅限运行时
修复了以下 bug:如果
LaunchingExternalURIScheme
附加了事件处理程序,并且启用了“ 始终记住 ”复选框,并且用户选中此复选框,则再次错误地显示对话框。修复了以下问题:视觉对象托管中的文本编辑控件在丢失并重新获得焦点时会复制 IME 输入。
修复了完全信任的 UWP 应用无法显示拥有的窗口的问题。
仅 SDK
- 修复了 SDK 中导致 .NET 项目平台列表中出现错误的 <平台> 值的问题。 (问题 #1755)
1.0.2584-prerelease
发布日期:2024 年 5 月 28 日
用于 WebView2 SDK 1.0.2584-prerelease 的 NuGet 包
为了完全实现 API 兼容性,此预发布版本的 WebView2 SDK 需要Microsoft Edge 版本 126.0.2584.0 或更高版本随附的 WebView2 运行时。
实验性功能
- 引入了取消 WebView2 中初始导航的选项,以提高启动性能。 此更改默认处于禁用状态,并且可以使用功能标志启用
msWebView2CancelInitialNavigation
。
实验性 API
此预发布 SDK 中未添加任何实验性 API。
促销
在此预发行版 SDK 中,尚未将任何 API 从实验版提升为稳定版。
错误修补程序
运行时和 SDK
- 修复了 .NET 主机对象异步方法返回 null 结果时的崩溃。 (问题 #4509)
仅限运行时
修复了关闭窗口时 WebView2 内存泄漏问题。 (问题 #4286)
修复了对 .NET 对象不起作用的问题
ignoreMemberNotFoundError
。 (问题 #4497)现在,当调用 缓冲区大小为 0 的 时
CreateSharedBuffer
,将返回正确的错误代码。 (问题 #4554)修复了插入点浏览对话框的激活问题。
修复了 WebView2 Visual Hosting
CursorChanged
事件未触发自定义游标的问题。
1.0.2478.35
发布日期:2024 年 4 月 22 日
WebView2 SDK 1.0.2478.35 的 NuGet 包
为了完全实现 API 兼容性,此 WebView2 SDK 版本需要 WebView2 运行时版本 124.0.2478.35 或更高版本。
促销
以下 API 已提升为稳定版,现已包含在此发布 SDK 中。
- 添加了运行时选择功能,以支持更多预发布测试和外部测试方案。 可以指定
ReleaseChannels
以选择在创建环境期间搜索的通道,以及ChannelSearchKind
选择搜索顺序。
CoreWebView2EnvironmentOptions
类:CoreWebView2ChannelSearchKind Enum
MostStable
LeastStable
CoreWebView2ReleaseChannels 枚举
None
Stable
Beta
Dev
Canary
错误修补程序
仅限运行时
- 修复了在 WebMessage API 中使用
AdditionalObjects
时可能导致崩溃的潜在整数溢出。
1.0.2526-prerelease
发布日期:2024 年 4 月 22 日
用于 WebView2 SDK 1.0.2526-prerelease 的 NuGet 包
为了完全实现 API 兼容性,此预发布版本的 WebView2 SDK 需要Microsoft Edge 版本 125.0.2526.0 或更高版本随附的 WebView2 运行时。
中断性变更
.NET WebView2(包括 WPF 和 WinForms 控件)的最低.NET Framework版本要求已从 .NET Framework 4.5 更新到 .NET Framework 4.6.2。
实验性 API
此预发布 SDK 中添加了以下实验性 API。
- 添加了
SaveAs
允许以编程方式执行 “另存为” 操作的 API。 可以使用这些 API 来阻止默认的“ 另存为 ”对话框,然后以无提示方式保存,或生成自己的 UI 以用于 “另存为”。 这些 API 仅适用于 “另存为 ”对话框,而不适用于“ 下载 ”对话框,后者继续使用现有下载 API。
CoreWebView2
类:-
Complete
Default
HtmlOnly
SingleFile
-
Cancelled
FileAlreadyExists
InvalidPath
KindNotSupported
Success
CoreWebView2SaveAsUIShowingEventArgs
类:- CoreWebView2SaveAsUIShowingEventArgs.AllowReplace 属性
- CoreWebView2SaveAsUIShowingEventArgs.Cancel 属性
- CoreWebView2SaveAsUIShowingEventArgs.ContentMimeType 属性
- CoreWebView2SaveAsUIShowingEventArgs.Kind 属性
- CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath 属性
- CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog 属性
- CoreWebView2SaveAsUIShowingEventArgs.GetDeferral 方法
促销
在此预发行版 SDK 中,以下 API 已从实验性提升为稳定 API。
- 支持 Fluent 样式覆盖滚动条。
CoreWebView2EnvironmentOptions
类:-
Default
FluentOverlay
错误修补程序
运行时和 SDK
修复了 WinRT JavaScript 投影中的 bug,其中传入类型化数组会导致“接口不支持”错误。 (问题 #3486)
添加了对在 WinRT JavaScript 投影中处理
out
数组参数的支持。
仅限运行时
修复了默认启用图像自动字幕功能的 bug。
修复了以下 bug:如果
LaunchingExternalURIScheme
附加了事件处理程序,如果启用了“ 始终记住 ”复选框,并且用户选中此复选框,对话框将再次错误地显示。修复了
GetNonClientRegionAtPoint
某些点返回Nowhere
错误的问题。修复了文本服务框架在将文件拖放到 WebView2 区域时断开连接的 bug。
修复了当设置为
false
时AreDevToolsEnabled
,视图源 Ctrl+U 键盘快捷方式保持启用状态的 bug。修复了在重新获得焦点时复制可组合输入法的 bug。 (问题 #1610)
确保
devicePixelRatio
与自定义光栅化比例同步。 (问题 #3060)修复了在 中使用
CallDevToolsProtocolMethod
NewWindowRequested
事件时的争用条件。 (问题 #4181)修复了在已销毁但
Controller
用户尝试按 Tab 键进入控件时 WPFTabIntoCore
中可能发生的崩溃 () 。 (问题 #4452)确保拼写检查采用不区分大小写格式的输入语言。
使语言 API 在用户输入方面更加可靠。
修复了不显示 “保存密码?” 提示的 bug。
仅 SDK
- 修复了 WinRT 投影中缺少
AreBrowserExtensionsEnabled
的 API。
1.0.2420.47
发布日期:2024 年 3 月 25 日
用于 WebView2 SDK 1.0.2420.47 的 NuGet 包
为了完全实现 API 兼容性,此 WebView2 SDK 版本需要 WebView2 运行时版本 123.0.2420.47 或更高版本。
促销
以下 API 已提升为稳定版,现已包含在此发布 SDK 中。
- 添加了一个新的 API,用于在 WebView2 包含的区域上提供命中测试结果。 对于希望在 WebView2 窗口的非工作区上处理鼠标事件的可视托管应用程序,此 API 非常有用。
CoreWebView2CompositionController
类:CoreWebView2NonClientRegionChangedEventArgs
类:CoreWebView2NonClientRegionKind 枚举
Caption
Client
Nowhere
CoreWebView2Settings
类:
-
FailureSourceModulePath
向ProcessFailedEventArgs
类型添加了 属性,以指定在 Windows 代码完整性失败的情况下导致崩溃的模块的完整路径,即当进程以 退出时。STATUS_INVALID_IMAGE_HASH
-
CoreWebView2ProcessFailedEventArgs
类:
错误修补程序
仅 SDK
- WinForms 和 WPF 的 .NET 程序集现在随附并启用了优化。 (问题 #4409)
1.0.2470-prerelease
发布日期:2024 年 3 月 25 日
用于 WebView2 SDK 1.0.2470-prerelease 的 NuGet 包
为了完全实现 API 兼容性,此预发布版本的 WebView2 SDK 需要 WebView2 运行时版本 124.0.2470.0 或更高版本。
实验性 API
此预发布 SDK 中添加了以下实验性 API。
- 支持 Fluent 样式覆盖滚动条。
CoreWebView2EnvironmentOptions
类:-
Default
FluentOverlay
- 更新了 WebMessageObjects API,允许将 DOM 对象注入到通过应用和
CoreWebView2.PostWebMessage
API 向其他方向构造的 WebView2 内容中。 添加了一个新的 Web 对象类型来表示文件系统句柄,该句柄可以发布到 Web 内容,以便为其提供文件系统访问权限。
CoreWebView2
类:CoreWebView2Environment
类:CoreWebView2FileSystemHandle
类:CoreWebView2FileSystemHandleKind 枚举
File
Directory
CoreWebView2FileSystemHandlePermission 枚举
ReadOnly
ReadWrite
促销
在此预发行版 SDK 中,以下 API 已从实验性提升为稳定 API。
- 添加了运行时选择功能,以支持更多预发布测试和外部测试方案。 可以指定
ReleaseChannels
以选择在创建环境期间搜索的通道,以及ChannelSearchKind
选择搜索顺序。
CoreWebView2EnvironmentOptions
类:CoreWebView2ChannelSearchKind Enum
MostStable
LeastStable
CoreWebView2ReleaseChannels 枚举
None
Stable
Beta
Dev
Canary
-
FailureSourceModulePath
向ProcessFailedEventArgs
类型添加了 属性,以指定在 Windows 代码完整性失败的情况下导致崩溃的模块的完整路径,即当进程以 退出时。STATUS_INVALID_IMAGE_HASH
-
CoreWebView2ProcessFailedEventArgs
类:
错误修补程序
仅限运行时
修复了在卸载旧版 WebView2 客户端 DLL 时可能导致应用程序进程崩溃的可靠性回归。
确保 WebView2 临时下载文件夹对于每个用户数据文件夹是唯一的,并且不会干扰其他应用或浏览器。
1.0.2365.46
发布日期:2024 年 2 月 26 日
用于 WebView2 SDK 1.0.2365.46 的 NuGet 包
为了完全实现 API 兼容性,此 WebView2 SDK 版本需要 WebView2 运行时版本 122.0.2365.46 或更高版本。
促销
以下 API 已提升为稳定版,现已包含在此发布 SDK 中。
- 添加了对
WebResourceRequested
辅助角色的支持,允许设置筛选器,以便接收WebResourceRequested
服务辅助角色、共享辅助角色和不同源 iframe 的事件。
CoreWebView2
类:CoreWebView2WebResourceRequestedEventArgs
类:
- 若要支持 WebView2 中的浏览器扩展,请为 WinRT 添加
GetBrowserExtensions
:
错误修补程序
仅限运行时
修复了当新窗口设置为源 WebView 时影响事件处理的
NewWindowRequested
回归。 (问题 #4250)修复了关闭具有嵌入 PDF 查看器的 WebView 可能导致崩溃的 bug。 (问题 #3832)
修复了在应用程序启用
SetWindowDisplayAffinity
时鼠标单击停止工作的回归。 (问题 #4325)
1.0.2415-prerelease
发布日期:2024 年 2 月 26 日
用于 WebView2 SDK 1.0.2415-prerelease 的 NuGet 包
为了完全实现 API 兼容性,此预发布版本的 WebView2 SDK 需要随 Microsoft Edge 版本 123.0.2415.0 或更高版本附带的 WebView2 运行时。
中断性变更
- 的 属性
CoreWebView2LaunchingExternalUriSchemeEventArgs
的行为InitiatingOrigin
已更改。InitiatingOrigin
如果 是不透明的原点,则InitiatingOrigin
事件 args 中报告的 是其前身原点。 前导原点是创建不透明原点的原点。 例如,如果位于example.com
的帧打开具有不同不透明原点的子帧,则子帧的前身原点为example.com
。
-
CoreWebView2LaunchingExternalUriSchemeEventArgs
类:
- 枚举的成员
CoreWebView2TextureStreamErrorKind
已重命名:
旧成员名称:
-
CoreWebView2TextureStreamErrorKind 枚举
CoreWebView2TextureStreamErrorNoVideoTrackStarted
CoreWebView2TextureStreamErrorTextureError
CoreWebView2TextureStreamErrorTextureInUse
新成员名称:
-
CoreWebView2TextureStreamErrorKind 枚举
NoVideoTrackStarted
TextureError
TextureInUse
实验性 API
此预发布 SDK 中添加了以下实验性 API。
- 类
CoreWebView2ControllerOptions
现在具有一个AllowHostInputProcessing
属性,它允许用户输入消息 (键盘、鼠标、触摸和笔) 通过浏览器窗口,由应用进程窗口接收。
-
CoreWebView2ControllerOptions
类:
促销
在此预发行版 SDK 中,以下 API 已从实验性提升为稳定 API。
- 添加了一个新的 API,用于在 WebView2 包含的区域上提供命中测试结果。 对于希望在 WebView2 窗口的非工作区上处理鼠标事件的可视托管应用程序,此 API 非常有用。
CoreWebView2CompositionController
类:CoreWebView2Settings
类:
错误修补程序
仅限运行时
修复了当权限请求设置为“未持久
SavesInProfile = false
化” (即) 时,相机或麦克风无法在 Google Meet 或Microsoft Teams 会议中打开。 (问题 #3592)修复了在 WebView2 浏览器进程中追加空
--edge-webview-custom-scheme
命令行开关的修复。禁用了全局
UserDataFolder
注册表项,因此只能按应用应用应用此注册表项。修复了
NewWindowRequested
浏览器扩展打开时未触发的事件。 (问题 #3841)修复了
NewWindowRequested
打开视图源时未触发的事件。 (问题 #4162)修复了下载涉及导航时触发
StateChanged
和BytesReceivedChanged
事件的问题。修复了对话框导致 WebView2 窗口意外跳转位置的 bug
BeforeUnload
。 (问题 #4350)修复了在 PDF 完全加载之前,如果调用太早,则打印空白页的问题
PrintAsync
。 (问题 #3779)
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 获取,以便更方便地与字符串结果交互:
CoreWebView2
类:
错误修补程序
仅限运行时
确保拼写检查语言以编程方式匹配
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 非常有用。
CoreWebView2CompositionController
类:CoreWebView2Settings
类:
促销
在此预发行版 SDK 中,以下 API 已从实验性提升为稳定 API。
-
CoreWebView2AcceleratorKeyPressedEventArgs
具有一个新IsBrowserAcceleratorKeyEnabled
属性,用于控制浏览器是否处理快捷键 (快捷键) ,例如 Ctrl+P 或 F3:
-
CoreWebView2AcceleratorKeyPressedEventArgs
类:
- 帧进程信息 API(包括
GetProcessExtendedInfos
)提供在关联呈现器进程中主动运行的所有帧的快照集合。 此 API 使主机应用程序能够检测 WebView2 的哪个部分消耗了内存或 CPU 使用率等资源:
CoreWebView2Environment
类:CoreWebView2ProcessExtendedInfo
类:CoreWebView2
类:CoreWebView2Frame
类:CoreWebView2FrameInfo
类:
-
ExecuteScriptWithResult
如果脚本失败,则提供异常信息。TryGetResultAsString
将脚本执行结果作为字符串而不是 JSON 获取,以便更方便地与字符串结果交互:
CoreWebView2
类:
-
CreateFromComICoreWebView2
将现有ICoreWebView2
对象包装在 实例中CoreWebView2
,使 .NET 开发人员能够与在 C++ 中创建的控件进行交互。
-
CoreWebView2
类:
- 若要支持 WebView2 中的浏览器扩展,请为 WinRT 添加
GetBrowserExtensions
:
- 添加了对
WebResourceRequested
辅助角色的支持,允许设置筛选器,以便接收WebResourceRequested
服务辅助角色、共享辅助角色和不同源 iframe 的事件。
CoreWebView2
类:CoreWebView2WebResourceRequestedEventArgs
类:
错误修补程序
仅限运行时
修复了关闭具有嵌入 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设备,则需要 () 运行几个 ACL shell 命令icacls
,以避免由于 WebView2 中实现的新安全功能而崩溃。 请参阅 [中断性变更] 在 Win10 上使用固定版本 v120+ 解压缩的 Win32 应用需要 ACL。 修补程序位于文章分发应用和 WebView2 运行时,有关固定版本运行时分发模式的详细信息部分,步骤“在Windows 10设备上,从固定版本 120 开始,使用固定版本的未打包 Win32 应用程序的开发人员必须运行以下命令。
促销
以下 API 已提升为稳定版,现已包含在此发布 SDK 中。
- 支持 WebView2 中的浏览器扩展:
CoreWebView2EnvironmentOptions
类:CoreWebView2Profile
类:
- 帧进程信息 API(包括
GetProcessExtendedInfos
)提供在关联呈现器进程中主动运行的所有帧的快照集合。 此 API 使主机应用程序能够检测 WebView2 的哪个部分消耗了内存或 CPU 使用率等资源:
CoreWebView2Environment
类:CoreWebView2ProcessExtendedInfo
类:CoreWebView2
类:CoreWebView2Frame
类:CoreWebView2FrameInfo
类:
-
ICoreWebView2AcceleratorKeyPressedEventArgs
具有一个新IsBrowserAcceleratorKeyEnabled
属性,允许开发人员控制浏览器是否处理快捷键 (快捷键) ,例如 Ctrl+P 或 F3:
-
CoreWebView2AcceleratorKeyPressedEventArgs
类:
- 添加了对管理配置文件删除的支持:
-
CoreWebView2Profile
类:
错误修补程序
在 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
,以标识请求的源:
-
CoreWebView2NewWindowRequestedEventArgs
类:
- 对于 WinRT,已添加选项以在创建
CoreWebView2Environment
时管理自定义方案注册:
CoreWebView2CustomSchemeRegistration
类:CoreWebView2EnvironmentOptions
类:
错误修补程序
- 修复了创建多个 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 中的浏览器扩展:
- CoreWebView2BrowserExtension 类
-
CoreWebView2EnvironmentOptions
类: -
CoreWebView2Profile
类:
错误修补程序
修复了以下问题:在更改监视器规模或在 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
-
CoreWebView2ProcessFailedEventArgs
类:
错误修补程序
在 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 使用率等资源:
CoreWebView2Environment
类:CoreWebView2FrameKind
枚举:
促销
在此预发行版 SDK 中,以下 API 已从实验性提升为稳定 API。
- 对于 WinRT,已添加选项以在创建
CoreWebView2Environment
时管理自定义方案注册:
CoreWebView2CustomSchemeRegistration
类:CoreWebView2EnvironmentOptions
类:
- 向事件参数添加了源帧信息
NewWindowRequested
,以标识请求的源:
-
CoreWebView2NewWindowRequestedEventArgs
类:
错误修补程序
运行时
更新了屏幕截图 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
添加了源帧信息,以支持标识源:
-
CoreWebView2NewWindowRequestedEventArgs
类
错误修补程序
已禁用在 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
获取每个导航的导航类型,例如后退/前进、重载或导航到新文档。
-
CoreWebView2NavigationStartingEventArgs
类: - CoreWebView2NavigationKind 枚举
-
ServiceWorkers
枚举中的BrowsingDataKinds
枚举值指定为源注册的服务辅助角色。
-
CoreWebView2BrowsingDataKinds
枚举:
错误修补程序
- 修复了同时隐藏书签、搜索和 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 的运行时内存使用情况。
-
CoreWebView2
类: -
CoreWebView2Environment
类: -
CoreWebView2Frame
类: -
CoreWebView2FrameInfo
类: -
CoreWebView2FrameKind 枚举
Iframe
MainFrame
Other
-
CoreWebView2ProcessInfo
类:
- 支持 WebView2 中的扩展。
- CoreWebView2BrowserExtension 类
-
CoreWebView2EnvironmentOptions
类: -
CoreWebView2Profile
类:
- 枚举
TextDirectionKind
将文本方向指定为从左到右或从右到左。
-
CoreWebView2TextDirectionKind 枚举
Default
LeftToRight
RightToLeft
错误修补程序
CoreWebView2Frame.ExecuteScriptAsync
修复了在脚本执行过程中销毁帧时发生的挂起。 问题 3124COMException
修复了在重定向后读取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 方案) 。
-
CoreWebView2
类: -
CoreWebView2LaunchingExternalUriSchemeEventArgs 类
- CoreWebView2LaunchingExternalUriSchemeEventArgs.Cancel 属性
- CoreWebView2LaunchingExternalUriSchemeEventArgs.InitiatingOrigin 属性
- CoreWebView2LaunchingExternalUriSchemeEventArgs.IsUserInitiated 属性
- CoreWebView2LaunchingExternalUriSchemeEventArgs.Uri 属性
- CoreWebView2LaunchingExternalUriSchemeEventArgs.GetDeferral 方法
-
MemoryUsageTargetLevel
指定内存消耗级别,例如low
或normal
。
- 增强了对多个配置文件的支持,允许为不同的配置文件配置常规自动填充和密码自动保存设置。
-
CoreWebView2Profile
类:
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
获取每个导航的导航类型,例如后退/前进、重载或导航到新文档。
-
CoreWebView2NavigationStartingEventArgs
类: - CoreWebView2NavigationKind 枚举
-
ServiceWorkers
枚举中的BrowsingDataKinds
枚举值指定为源注册的服务辅助角色。
-
CoreWebView2BrowsingDataKinds
枚举:
-
LaunchingExternalUriScheme
尝试启动向 OS 注册的 URI 方案时,将引发该事件 (外部 URI 方案) 。
-
CoreWebView2
类: -
CoreWebView2LaunchingExternalUriSchemeEventArgs 类
- CoreWebView2LaunchingExternalUriSchemeEventArgs.Cancel 属性
- CoreWebView2LaunchingExternalUriSchemeEventArgs.InitiatingOrigin 属性
- CoreWebView2LaunchingExternalUriSchemeEventArgs.IsUserInitiated 属性
- CoreWebView2LaunchingExternalUriSchemeEventArgs.Uri 属性
- CoreWebView2LaunchingExternalUriSchemeEventArgs.GetDeferral 方法
-
MemoryUsageTargetLevel
指定内存消耗级别,例如low
或normal
。
错误修补程序
枚举某些
webhosthidden
类型时,使用wv2winrt webhosthidden
输入了无限循环。 仅 (SDK)在 wv2winrt 工具生成的代码中,调用异步方法时,如果成功但返回
null
IAsyncAction
而不是 ,则它会崩溃。 仅 (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
传递的 DOMFile
对象。
- CoreWebView2File 类
-
CoreWebView2WebMessageReceivedEventArgs
类:
- 配置文件 Cookie 管理器 API 支持配置文件管理。 属性
CookieManager
使主机应用能够获取配置文件的 Cookie 管理器。
-
CoreWebView2Profile
类:
错误修补程序
- 修复了允许应用在新窗口创建前调用
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。
- 增强了对多个配置文件的支持,允许为不同的配置文件配置常规自动填充和密码自动保存设置。
-
CoreWebView2Profile
类:
错误修补程序
禁用了显示允许安装扩展的选项的 Chrome Web Store 信息横幅。 (问题 #3312)
修复了自定义菜单项未触发的问题。 (问题 #3300)
修复了使用 WPF 和 SDK 版本 1.0.1722.32(现已弃用)创建 WebView2 时初始化时出现的故障。 (请参阅下面 已弃用 SDK 1.0.1722.32 。) (问题 #3375)
修复了在
PostSharedBufferToScript
发布大约 32000x1MB 缓冲区后停止的 bug。 (仅限运行时) (问题 #3360)
-
CoreWebView2
类:
修复了始终在事件回调中
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。
CoreWebView2Settings
- API
PermissionKind.WindowManagement
指示权限请求的类型。
-
CoreWebView2PermissionKind
枚举
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
传递的 DOMFile
对象。
CoreWebView2WebMessageReceivedEventArgs
- 配置文件 Cookie 管理器 API 支持配置文件管理。 属性
CookieManager
使主机应用能够获取配置文件的 Cookie 管理器。
CoreWebView2Profile
错误修补程序
修复了从其他线程释放 WebView 时出现崩溃问题。 (仅限运行时) (问题 #3062)
修复了当包装在 中时焦点被困在 WebView2 控件内的
ContainerControl
bug。 (问题 #2835)通过在 WebView2 中禁用可
.pdf
编辑的临时缓存数据恢复功能,修复了此问题。 (问题 #3274)禁用了显示允许安装扩展的选项的 Chrome Web Store 信息横幅。 (问题 #3312)
修复了屏幕阅读器无法调出新下载项的问题。
修复了视觉对象托管拥有的窗口未正确映射鼠标指针输入的 bug。
修复了已取消的“另存为”对话框引发的 bug
DownloadStarting
。 仅 (运行时)
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:
CoreWebView2
类CoreWebView2Environment
类CoreWebView2Frame
类CoreWebView2SharedBufferAccess 枚举
ReadOnly
ReadWrite
- 用于管理权限的 API:
CoreWebView2PermissionKind
枚举CoreWebView2PermissionRequestedEventArgs
事件CoreWebView2Profile
类
用于管理跟踪防护的 API:
CoreWebView2EnvironmentOptions
类CoreWebView2Profile
类CoreWebView2TrackingPreventionLevel Enum
None
Basic
Balanced
Strict
- 用于管理控制器脚本区域设置值的 API:
-
CoreWebView2ControllerOptions
类
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 的支持:
CoreWebView2LaunchingExternalUriSchemeEventArgs 类
- CoreWebView2LaunchingExternalUriSchemeEventArgs.Cancel 属性
- CoreWebView2LaunchingExternalUriSchemeEventArgs.GetDeferral 方法
- CoreWebView2LaunchingExternalUriSchemeEventArgs.InitiatingOrigin 属性
- CoreWebView2LaunchingExternalUriSchemeEventArgs.IsUserInitiated 属性
- CoreWebView2LaunchingExternalUriSchemeEventArgs.Uri 属性
- 添加了对纹理流式处理的支持:
Environment
返回接口的TextureStream
接口:
- CoreWebView2Environment.CreateTextureStream 方法
- CoreWebView2Environment.RenderAdapterLUIDChanged 事件
- CoreWebView2Environment.RenderAdapterLUID 属性
接口 TextureStream
:
-
CoreWebView2TextureStream 类
- CoreWebView2TextureStream.AddAllowedOrigin 方法
- CoreWebView2TextureStream.CloseTexture 方法
- CoreWebView2TextureStream.CreateTexture 方法
- CoreWebView2TextureStream.ErrorReceived 事件
- CoreWebView2TextureStream.GetAvailableTexture 方法
- CoreWebView2TextureStream.Id 属性
- CoreWebView2TextureStream.PresentTexture 方法
- CoreWebView2TextureStream.RemoveAllowedOrigin 方法
- CoreWebView2TextureStream.SetD3DDevice 方法
- CoreWebView2TextureStream.StartRequested 事件
- CoreWebView2TextureStream.Stop 方法
- CoreWebView2TextureStream.Stopped 事件
- CoreWebView2TextureStream.WebTextureReceived 事件
- CoreWebView2TextureStream.WebTextureStreamStopped 事件
ErrorReceivedEventArgs:
WebTextureReceivedEventArgs:
- CoreWebView2TextureStreamWebTextureReceivedEventArgs 类
- CoreWebView2TextureStreamWebTextureReceivedEventArgs.WebTexture 属性
TextureStream 错误类型枚举:
Texture
主机写入的接口,以便呈现器将呈现在它上:
呈现器写入的接收 WebTexture
接口,以便主机将对其进行读取:
- 添加了对配置文件管理的支持:自定义数据分区、Cookie 管理器和配置文件删除:
添加了对自定义数据分区的支持:
添加了对 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:
1619-prerelease 中的上一个名称:
错误修补程序
修复了在收到事件时
BeforeUnload
WebView2 未正确关闭的 bug。 (仅限运行时) (问题 #2677)在 事件中
DownloadStarting
ResultFilePath
,在附加事件处理程序时DownloadStarting
,先前未显示 UWP 应用程序的正确下载位置。 此问题已修复:现在显示正确的ResultFilePath
。修复了调用 方法返回非泛型任务时
HostObject
引发的 bugSystem.ArgumentException
。 (问题 #2787)修复了 API 中
SharedBuffer
流对象不能很好地与 配合使用StreamWriter
的问题。 (仅限运行时) (问题 #3108)DOM 语音合成 API(如
SpeechSynthesis.getVoices()
)现在可在 UWP 应用中使用。 仅 (运行时)修复了帧销毁时发生的崩溃。 (仅限运行时) (问题 #3062)
修复了在尝试使用短语进行调用
CreateWebResourceResponse
时应用崩溃的null
reason
bug。 仅 (运行时)选项
CoreWebView2.AddHostObjectToScript
chrome.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:
- CoreWebView2.PrintAsync 方法
- CoreWebView2.PrintToPdfStreamAsync 方法
- CoreWebView2.ShowPrintUI 方法
-
CoreWebView2PrintSettings 类
- CoreWebView2PrintSettings.Collation 属性
- CoreWebView2PrintSettings.ColorMode 属性
- CoreWebView2PrintSettings.Copies 属性
- CoreWebView2PrintSettings.Duplex 属性
- CoreWebView2PrintSettings.MediaSize 属性
- CoreWebView2PrintSettings.PageRanges 属性
- CoreWebView2PrintSettings.PagesPerSide 属性
- CoreWebView2PrintSettings.PrinterName 属性
- 自定义崩溃报告 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 的支持:
- CoreWebView2PermissionRequestedEventArgs 类
- CoreWebView2Profile 类
-
CoreWebView2PermissionSetting 类
- CoreWebView2PermissionSetting.PermissionKind 属性
-
CoreWebView2PermissionKind 枚举
MultipleAutomaticDownloads
FileReadWrite
Autoplay
LocalFonts
MidiSystemExclusiveMessageAccess
- CoreWebView2PermissionSetting.PermissionOrigin 属性
- CoreWebView2PermissionSetting.PermissionState 属性
- 添加了对 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 的支持:
- CoreWebView2.PrintAsync 方法
- CoreWebView2.PrintToPdfStreamAsync 方法
- CoreWebView2.ShowPrintUI 方法
-
CoreWebView2PrintSettings 类
- CoreWebView2PrintSettings.Collation 属性
- CoreWebView2PrintSettings.ColorMode 属性
- CoreWebView2PrintSettings.Copies 属性
- CoreWebView2PrintSettings.Duplex 属性
- CoreWebView2PrintSettings.MediaSize 属性
- CoreWebView2PrintSettings.PageRanges 属性
- CoreWebView2PrintSettings.PagesPerSide 属性
- CoreWebView2PrintSettings.PrinterName 属性
- 添加了对自定义崩溃报告 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。
- 添加了对创建具有指定大小的基于共享内存的缓冲区的支持:
-
CoreWebView2SharedBuffer 类
Buffer
FileMappingHandle
Size
Close
Dispose
OpenStream
- 添加了对从 main 帧或
iframe
的脚本访问共享缓冲区对象的支持:
- 在当前顶级文档中添加了对从
JavaScript
参数运行 JavaScript 代码的支持:
-
CoreWebView2ScriptException 类
ColumnNumber
LineNumber
Message
Name
ToJson
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 的支持:
- CoreWebView2.PrintAsync 方法
- CoreWebView2.PrintToPdfStreamAsync 方法
- CoreWebView2.ShowPrintUI 方法
-
CoreWebView2PrintSettings 类
- CoreWebView2PrintSettings.Collation 属性
- CoreWebView2PrintSettings.ColorMode 属性
- CoreWebView2PrintSettings.Copies 属性
- CoreWebView2PrintSettings.Duplex 属性
- CoreWebView2PrintSettings.MediaSize 属性
- CoreWebView2PrintSettings.PageRanges 属性
- CoreWebView2PrintSettings.PagesPerSide 属性
- CoreWebView2PrintSettings.PrinterName 属性
- 添加了对 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 中的 wv2winrt
IMap
和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 中。
- 添加了
ContextMenuRequested
API,使主机应用能够创建或修改其自己的上下文菜单。
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 中。
支持 WebView2 中的 多个用户配置文件 。
主题 API 提供了一种将 WebView2 颜色主题自定义为
light
、dark
或system
的方法。默认下载 API ,提供自定义默认下载位置的方法。
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 中。
支持
sessionId
CDP 方法调用的 CallDevToolsProtocolMethodForSession API。-
add_StatusBarTextChanged
get_StatusBarText
remove_StatusBarTextChanged
支持启用/禁用外部放置操作的 AllowExternalDrop API 。
HiddenPdfToolbarItems API 可用于自定义 PDF 工具栏项。
ExclusiveUserDataFolderAccess API 允许控制其他进程是否可以使用
WebView2Environment
同一用户数据文件夹创建 WebView2,从而共享相同的 WebView 浏览器进程实例。请求 对 iframe 的权限支持:
add_PermissionRequested
remove_PermissionRequested
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。
支持 WebView2 中的 多个用户配置文件 。
主题 API 提供了一种将 WebView2 颜色主题自定义为
light
、dark
或system
的方法。默认下载 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 中。
- BasicAuthentication API,使开发人员能够处理基本 HTTP 身份验证请求和响应。
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。
- 添加了 ContextMenuRequested API ,使主机应用能够创建或修改自己的上下文菜单。
促销
在此预发行版 SDK 中,以下 API 已从实验性提升为稳定 API。
- 对 CDP 方法调用支持 sessionId 的 CallDevToolsProtocolMethodForSession API 。
-
StatusBarText API:
add_StatusBarTextChanged
get_StatusBarText
remove_StatusBarTextChanged
- 支持启用/禁用外部 删除的 AllowExternalDrop API 。
- HiddenPdfToolbarItems API 可用于自定义 PDF 工具栏项。
- ExclusiveUserDataFolderAccess API 允许控制其他进程是否可以使用相同的用户数据文件夹创建 WebView2。
错误修补程序
修复了 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 进程和进程集合的详细信息。
-
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。
- 将 ICoreWebView2ClientCertificate 重命名为 ICoreWebView2Certificate。
-
适用于 iframe 的新 API:
add_PermissionRequested
remove_PermissionRequested
错误修补程序
修复了导致 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。
-
适用于 iframe 的新 API:
PostWebMessageAsJson
PostWebMessageAsString
add_WebMessageReceived
remove_WebMessageReceived
- ProcessInfo API 提供有关 WebView2 进程 和 进程集合的详细信息。
- HTTP 身份验证 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
促销
在此预发行版 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)
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 边界的位置。 可以将下载对话框定位到“ 下载 ”按钮,而不是默认位置(右上角)。
- 以编程方式打开和关闭默认下载对话框。
- 做出更改以响应打开和关闭对话框。
错误修补程序
常规可靠性改进。
实际进程退出代码现在作为 中提供
ExitCode
ICoreWebView2ProcessFailedEventArgs2
,用于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 中。
- OpenTaskManagerWindow API。
- isSwipeNavigationEnabled 属性。
- BrowserProcessExited API。
- 接口上的
ICoreWebView2NewWindowRequestedEventArgs2
get_Name属性。
错误修补程序
- 修复了缺少 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 或更高版本。
常规功能
实验性 API
此预发布 SDK 中添加了以下实验性 API。
通过使用
EnsureCoreWebView2Async
删除了无提示故障,当多次调用时,使用不兼容的参数引发ArgumentException
。更改了环境对象中 UserDataFolder 属性的默认处理。
警告
中断性变更:如果用户数据文件夹的默认处理方式(如果开发人员未指定放置位置)将发生更改。 请参阅 公告:用户目录文件夹默认处理更新。
为 iframe 添加了 导航 & 脚本 API 。
添加了 MemoryUsageTargetLevel ,它允许开发人员指定内存消耗级别,例如低或正常。
向环境选项添加了 ExclusiveUserDataFolderAccess 。
添加了 HiddenPdfToolbarItems 以自定义 PDF 工具栏项。
添加了 PrintToPdf,允许将当前页打印为 PDF。 此外,还可以通过此新 API 使用可选的自定义设置。
添加了 AllowExternalDrop 属性,以允许从 WebView2 控件外部拖放对象。
添加了允许自定义 WebView2 上下文菜单的 ContextMenu 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
添加了 OpenTaskManagerWindow 以启动 WebView2 浏览器任务管理器。
添加了对虚拟主机名映射的支持,以便与服务辅助角色配合使用。
添加了 HiddenPdfToolbarItems 以自定义 PDF 工具栏项。
促销
在此预发行版 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 文件名的DownloadStartingEventArgs
bug。 (问题 #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 中。
- add_FrameCreated。
- get_IsGeneralAutofillEnabled。
- get_IsPinchZoomEnabled。
- 下载 API。
- AddHostObjectToScriptWithOrigins 支持 iframe 元素的 API。
错误修补程序
修复了破坏
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。
- 下载 API。
- PinchZoom API。
- AddFrameCreated。
- AddHostObjectToScriptWithOrigins API 已提升为具有 iframe 元素支持的稳定版。
-
自动填充 API。
注意
当前没有用于删除本地存储的常规自动填充和密码自动保存信息的 API。 请提供删除数据的控件,这将涉及删除整个用户数据文件夹。
错误修补程序
修复了鼠标左键单击不关闭上下文菜单的 bug。 此更改特定于运行时。
修复了当共享同一用户数据文件夹的应用的 exe 文件的版本信息不一致时,WebView2 创建失败的 bug。
修复了一个 bug,
Home
即 、 和Back
等Refresh
特殊浏览器键不能被AreBrowserAcceleratorKeysEnabled
禁用。 此更改特定于运行时。修复了 WebView2 .NET 控件中的 bug,其中 WebView2 窗口在后台创建时为空。 (问题 #1077)
通过按 Enter 或 Esc 关闭文件选取器对话框不再使用 WebView2 控件崩溃 WPF 应用程序。 (问题 #1099)
修复了附加事件处理程序时
WebResourceRequested
AllowSingleSignOnUsingOSPrimaryAccount 无法与 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。
添加了 IsPinchZoomEnabled 设置。 它允许在设置中打开或关闭页面缩放控件。
添加了自定义 add_DownloadStarting API。 它允许你阻止下载,保存到其他路径,并访问所需的元数据来生成自定义下载 UI。
从 AddHostObjectToScriptWithOrigins 添加了
iframe
元素支持。添加了 WPF 示例应用 的示例代码,以使用 API 关闭浏览器函数键。
添加了 UpdateRuntime API,以轻松更新 WebView2 运行时。
错误修补程序
修复了 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 Designer 模式下添加了 WebView2 UI 元素。
错误修补程序
通过将每个说明包装在更详细的 .NET 异常中,改进了 COM 异常说明。 (问题 #338) 。 此更改特定于运行时。
修复了在选择 Tab 切换焦点时导致 WebView2 控件在Microsoft Visual Studio Tools for Office崩溃时引发的 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。
光栅化缩放 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 中。
- DPI 支持 相关 API
- 视觉对象托管 API
- SetVirtualHostNameToFolderMapping
- TrySuspend 和 Resume
- DefaultBackgroundColor
错误修补程序
- 修复了在可视化托管模式下将 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 团队建议迁移到较新的包。
功能
- 添加了 TrySuspend 和 Resume 方法以暂停和恢复 WebViews。
- 添加了 SetVirtualHostNameToFolderMapping 方法,该方法将虚拟主机名映射到目录路径。 (问题 #37、 问题 #161 和 问题 #212) 。
- 添加了 DefaultBackgroundColor 属性,用于设置背景的颜色和 alpha 通道。 (问题 #414) 。
- 添加了 UserAgent 属性来获取或设置用户代理。 (问题 #122) 。
- 已将
CreateCookieWithCookie
方法替换为CopyCookie
方法。 - 添加了使用 ICoreWebView2CompositionController 接口的可视化托管支持,该接口使用 中的
ICoreWebView2Environment3
新CreateCoreWebView2CompositionController
方法创建。
促销
在此预发行版 SDK 中,以下 API 已从实验性提升为稳定 API。
- 视觉对象托管 API
- SetVirtualHostNameToFolderMapping
错误修补程序
已关闭 WebView2 中的Microsoft Edge 购物功能。
在 为 时
AreDefaultContextMenusEnabled
false
关闭了 PDF 查看器中的上下文菜单。 (问题 #605) 。修复了
E_NOINTERFACE
查询ICoreWebView2
时返回的ICoreWebView2Experimental
bug。 (问题 #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) 。
.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 中。
- WebResourceResponseReceived API
- NavigateWithWebResourceRequest API
- Cookie 管理 API
- DOMContentLoaded API
- Environment 属性
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。
- WebResourceResponseReceived API
- NavigateWithWebResourceRequest API
- Cookie 管理 API
- DOMContentLoaded API
- Environment 属性
.NET
功能
- 在 .NET Core 3.1+ 和 .NET 5 中打开 WinForms 设计器。
- 改进了 .NET Cookie 管理。 (问题 #611) 。
- 已替换为
CoreWebView2Ready
CoreWebView2InitializationCompleted。
错误修补程序
添加了 AcceleratorKeyPressed 事件以支持
AcceleratorKey
在 WebView2 中选择。 (问题 #288) 。删除了将不必要的文件输出到 WebView2 文件夹。 (问题 #461) 。
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 或更高版本。
常规功能
- 添加了 NavigateWithWebResourceRequest 方法,用于在导航期间提供发布数据或其他请求标头。
- 添加了在加载和分析初始 HTML 文档时运行的 DOMContentLoaded 事件。
- 在 WebView2 上添加了 Environment 属性。 此属性公开创建 WebView2 实例的 WebView2 环境。
- 添加了 Cookie 管理 API,使开发人员能够对 WebView2 会话进行身份验证,或从 WebView2 检索 Cookie 以对其他工具进行身份验证。 WebView2 团队计划进行特定于语言或框架的改进。 请参阅 API 评审:Cookie 管理。
- 更新了 WebResourceResponseReceived 事件,并将不可变 的 WebResourceResponseView 和 WebResourceResponseReceivedEventArgs::P opulateResponseContent 添加到 WebResourceResponseView::GetContent。
- 在 WebView2 中关闭Microsoft Defender 应用程序防护 (WDAG) 。
- 为 Visual Hosting 添加了 SystemCursorId 。
- 添加了针对 Visual Hosting 中的输入法修复的 bug。
- 删除了在使用 WebView2 静态库时对
version.lib
的要求。
.NET
- 更新了 CoreWebView2 类以公开
CoreWebView2Environment
变量。 - 将命名空间中
Microsoft.Web.WebView2.Core
自定义 EventArgs 类的实现更改为 System.EventArgs 或 System.ComponentModel.CancelEventArgs 的子类。 (问题 #250) - 在 WinForms 中添加了对 CoreWebView2CreationProperties 的支持。 (问题 #204) 。
- 添加了 WebResourceRequested .NET API。 (问题 #219) 。
- 将 WinForms Designer Source 属性更新为默认值或重置为 null。 (问题 #177) 。
- 更新了 WebView2.Init () 中的 WebView2 边界,以支持小于 100% 的 DPI 模式。 (问题 #432) 。
- 更新了 BuildWindowCore 和 DestroyWindowCore 以提高可靠性。 (问题 #382) 。
- 更新了 .NET 加载程序基础,以在进程位而不是操作系统体系结构上进行加载。 (问题 #431) 。
- 已
EdgeNotFoundException
重命名为 WebView2RuntimeNotFoundException。
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 或更高版本。
-
重要
公告:此 SDK 是 WebView2 Win32 C/C++ GA 的候选版本。 正式版应使用相同的 API 接口和功能。
已断开连接 的浏览器策略。
在 WebView2 环境选项上添加了 AllowSingleSignOnUsingOSPrimaryAccount 属性,以启用 WebView2 的条件访问。
更新
ICoreWebView2NewWindowRequestedEventArgs
为包括 WindowFeatures 属性和关联的 ICoreWebView2WindowFeatures。 (问题 #293) 。更新
System.Windows.Rect
为使用System.Drawing.Rectangle
而不是System.Windows.Rect
(问题 #235) 。更新了 NewWindowRequested 事件以处理
window.open()
不带参数的请求。 (问题 #293) 。使用
ICoreWebView2EnvironmentOptions
指定的 AdditionalBrowserArguments 不会被环境变量或注册表值重写。 请参阅 CreateCoreWebView2EnvironmentWithOptions。
0.9.579
发布日期:2020 年 7 月 20 日
用于 WebView2 SDK 0.9.579 的 NuGet 包
此版本的 WebView2 SDK 需要Microsoft Edge 版本 86.0.579.0 或更高版本。
所有平台
-
重要
公告:Evergreen WebView2 运行时和安装程序已发布预览版。 请参阅 分发应用和 WebView2 运行时。
添加了 WebView2 工作线程改进。 (问题 #318) 。
已关闭 WebView2 中的弹出窗口阻止程序。 请参阅 事件中的
NewWindowRequested
IsUserInitiated 属性。确保为
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++
添加了 ICoreWebView2ExperimentalNewWindowRequestedEventArgs::get_WindowFeatures,它运行并与 ICoreWebView2ExperimentalWindowFeatures (#70) 关联时
window.open()
触发。-
重要
中断性变更:已弃用 CreateCoreWebView2EnvironmentWithDetails ,并替换为 CreateCoreWebView2EnvironmentWithOptions。
-
重要
中断性变更:为确保 WebView2 API 符合 Windows API 命名约定,WebView2 团队更新了以下名称。
更新了 AddHostObjectToScript。 原始主机对象序列化程序标记现在设置为代理对象。 然后,在 JavaScript 回调 (#148) 中作为参数传递时,主机对象序列化程序标记作为主机对象重新序列化。
.NET (0.9.538 预发行版)
已发布 WinForms 和 WPF WebView2API 示例,它们是 WebView2 SDK 的综合指南。 请参阅 示例存储库。
添加了对视觉对象托管和窗口功能的支持,作为 实验性 API。
-
重要
中断性变更:以下延迟现在实现
IDisposable
: ScriptDialogOpening、 NewWindowRequested、 WebResourceRequested 和 PermissionRequested。 添加了 GetAvailableBrowserVersionString 和 CompareBrowserVersions 作为 CoreWebView2Environment 静态。
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 窗体特定 API 的 WebView2 Windows 窗体参考。
有关 CoreWebView2 API 的详细信息,请参阅 .NET 参考。
-
警告
已知问题:WebView2 团队知道预发行版中的一些问题正在将来的版本中解决。
- DPI 感知:WPF 的 WebView2 当前不是 DPI 感知。 在高 DPI 监视器上初始化 WebView2 时,存在一个已知问题,即 WebView2 控件首先初始化为窗口的一小部分,直到调整窗口大小。
- WPF Designer:目前不支持 WPF 设计器。 通过在文本编辑器中直接修改相应的 XAML,在应用中添加 WebView2 控件。
0.9.488
发布日期:2020 年 4 月 20 日
用于 WebView2 SDK 0.9.488 的 NuGet 包
此版本的 WebView2 SDK 需要Microsoft Edge 版本 84.0.488.0 或更高版本。
-
重要
公告:从即将发布的 Microsoft Edge 版本 83 开始,Evergreen WebView2 不再面向稳定浏览器通道。 相反,它面向另一组二进制文件(品牌为 Evergreen WebView2 Runtime),你可以通过 WebView2 团队当前正在开发的安装程序进行链式安装。 请参阅 分发应用和 WebView2 运行时。
-
重要
公告:今后,WebView2 团队发布了两个包:
- 预发布 SDK 包包含试验性 API (供你试用) ,以及已提升为稳定状态的 API。
- 完全由已达到稳定状态的 API 组成的发布 SDK 包, (置信度) 。
若要了解差异,请参阅 WebView2 的预发行版和发布 SDK。
-
重要
中断性变更:为确保 WebView2 API 符合 Windows API 命名约定,WebView2 团队更新了以下接口的名称。
-
CORE_WEBVIEW2_*
前缀现在COREWEBVIEW2_*
为 。 - GetCoreWebView2BrowserVersionInfo 现在是 GetAvailableCoreWebView2BrowserVersionString。
- get_BrowserVersionInfo 现已 get_BrowserVersionString。
- AddRemoteObject 现在是 AddHostObjectToScript。
- RemoveRemoteObject 现在是 RemoveHostObjectFromScript。
-
chrome.webview.remoteObjects
现在chrome.webview.hostObjects
为 。
-
-
重要
中断性变更:
AddRemoteObject
JS 代理方法也会重命名。-
getLocal
现在getLocalProperty
为 。 -
setLocal
现在setLocalProperty
为 。 -
getRemote
现在getHostProperty
为 。 -
setRemote
现在setHostProperty
为 。 -
applyRemote
现在applyHostFunction
为 。
-
-
重要
中断性变更:已弃用 CreateCoreWebView2EnvironmentWithDetails ,并替换为 CreateCoreWebView2EnvironmentWithOptions。
添加了 FrameNavigationCompleted 事件。 现在,当元素
iframe
完成导航时,将运行事件并返回导航的成功和导航 ID。添加了 ICoreWebView2EnvironmentOptions 接口,可用于确定应用面向的 Evergreen WebView2 运行时的版本。
添加了 IsBuiltInErrorPageEnabled 设置。 现在,你可以选择打开或关闭内置的错误网页,以导致导航失败和呈现进程失败。
更新了远程对象注入以支持 .NET
IDispatch
实现 (#113) 。更新 了 NewWindowRequested 事件以处理来自上下文菜单的请求 (#108) 。
发布了第一个单独的 WebView2 预发行版包,可在其中访问可视托管 API。 WebView2 团队更新了 APISample 以包含新的实验 API。
- 添加了 ICoreWebView2ExperimentalCompositionController 接口,用于连接到合成树并为 WebView2 控件提供输入。
- 添加了 ICoreWebView2ExperimentalPointerInfo,其中包含来自
POINTER_INFO
的所有信息。 此对象传递给 SendPointerInput,以将指针输入注入 WebView2。 - 添加了 ICoreWebView2ExperimentalCursorChangedEventHandler,它告知应用何时应更改 WebView2 控件上的鼠标光标。 当鼠标悬停在 WebView2 中的文本框上时,光标将从箭头更改为选择器。 上的
cursor
CompositionController
属性指示应用当前应为 WebView2 的鼠标光标。
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 团队将前缀
IWebView2WebView
ICoreWebView2
重命名为,以确保 WebView2 API 符合 Windows API 命名约定。 此外,为了从 UI 框架利用 WebView2 SDK,WebView2 团队分为ICoreWebView2
ICoreWebView2 和 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属性更改为
WebMessageReceivedEventArgs
TryGetWebMessageAsString 方法。 -
重要
中断性变更:将 Handle 方法更改为
AcceleratorKeyPressedEventArgs
get_Handled属性。
0.8.355
发布日期:2019 年 12 月 9 日
用于 WebView2 SDK 0.8.355 的 NuGet 包
此版本的 WebView2 SDK 需要Microsoft Edge 版本 80.0.355.0 或更高版本。
- 已发布 WebView2API 示例,这是 WebView2 SDK 的综合指南。 请参阅 API 示例。
- 添加了对除英语 (#30) 以外的所有语言的 IME 支持。
- 更新了事件的 API 图面,
WebResourceRequested
以响应 bug 报告。 现在已弃用在创建时同时指定筛选器和事件。 若要创建请求的 Web 资源事件,请使用 add_WebResourceRequested 添加事件,使用 AddWebResourceRequestedFilter 添加筛选器。 RemoveWebResourceRequestedFilter 删除筛选器 (#36) (#74) 。 -
重要
中断性变更:修改的全屏行为。 已弃用 的 IsFullScreenAllowed。 现在,默认情况下,如果 WebView2 控件中的元素 ((如视频) )设置为全屏,则会填充 WebView2 控件的边界。 使用 ContainsFullScreenElementChanged 事件和 get_ContainsFullScreenElement 指定如果元素想要进入全屏模式,应用应如何调整 WebView2 控件的大小。
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_CanGoBack
get_CanGoForward
GoForward
/GoBack
//用于在导航历史记录中后退和前进。 - 添加了 HTTP 标头类型 (
IWebView2HttpHeadersCollectionIterator
//IWebView2HttpRequestHeaders
IWebView2HttpRequestHeaders
) ,用于在 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 或更高版本。
初始开发人员预览版。
另请参阅
- 关于 WebView2 SDK 的发行说明
- WebView2 SDK 发行说明
- WebView2 功能和 API 概述 - 按功能区域概述了发布 SDK 包中的许多 API。
- 联系 Microsoft Edge WebView2 团队