预览运行时 156.0.4314.8 (2026 年 10 月 12 日)

Microsoft Edge WebView2 预览版运行时发行说明,发布日期:2026 年 10 月 12 日。

这是一个预览运行时,用于早期测试。 WebView2 SDK 的预发布测试使用 Microsoft Edge (Beta、Dev 或 Canary) 的预览渠道,其中包括 WebView2 预览运行时。

这些发行说明适用于 WebView2 预览运行时,其对应于 Microsoft Edge 的 Beta 预览频道。 建议在将这些更改提升为稳定版之前,使用 Microsoft Edge 的 Beta 预览频道测试应用。 如果想要更早地测试,可以针对 Edge Dev 或 Edge Canary 进行测试。

请参阅使用 Microsoft Edge 的预览频道进行预发布测试。

除了以下 WebView2 运行时改进之外,还可以使用 Microsoft Edge 156 中的新 Web 平台功能;请参阅 Microsoft Edge 156 Web 平台发行说明 (2026 年 10 月 22 日) 。

即将推出的重大更改:删除 msAbydosHandwritingAttr WebView2 浏览器标志

从 v159 开始,WebView2 将删除已弃用的 msAbydosHandwritingAttr 浏览器标志。 在此更改后,传递 msAbydosHandwritingAttrWEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS,基于注册表的浏览器参数,或 CoreWebView2EnvironmentOptions.AdditionalBrowserArguments 将不再启用预期的行为。

请查看应用和测试配置,并做出相应的规划。

这对应用意味着什么

  • 未设置 msAbydosHandwritingAttr的应用 :

    无需执行任何操作。

  • 设置 msAbydosHandwritingAttr 标志的应用或测试工具:

    删除 msAbydosHandwritingAttr 标志,并在没有它的情况下验证手写方案。

  • 通过环境变量或注册表设置配置浏览器参数的企业部署:

    从托管配置中删除 msAbydosHandwritingAttr 标志。

了解详细信息

共享反馈

有问题或遇到回归? 使用运行时版本、Windows 版本、配置和重现步骤在 WebView2Feedback 存储库 中提交问题。

即将推出的重大更改:Windows 上应用托管的 WebView2 固定版本运行时所需的 ACL 设置

从 v159 开始,WebView2 正在为应用托管的已修复版本部署加强呈现器沙盒。 部署和管理未打包的固定版本运行时的应用程序必须在安装、运行时更新和修复期间,在运行时文件夹上配置并保留所需的 Windows 访问控制列表 (ACL) 条目。

本指南适用于 Windows 10 和 Windows 11 上的应用托管、未打包的固定版本部署。 常青部署和 Windows 托管包文件夹不需要此安装程序操作。

这对应用意味着什么

  • 常青运行时:

    Microsoft 托管的运行时文件无需 ACL 操作。

  • 打包的应用和 Windows 托管的包位置:

    不要手动修改包文件夹 ACL。

  • 应用托管、未打包 固定版本运行时:

    更新安装程序、更新程序和维修流,以配置和验证所需的权限。

所需设置

从适当提升的安装程序上下文运行以下命令,替换 {Fixed Version path} 为应用程序部署的运行时文件夹:

icacls "{Fixed Version path}" /grant *S-1-15-2-2:(OI)(CI)(RX)
icacls "{Fixed Version path}" /grant *S-1-15-2-1:(OI)(CI)(RX)

这些条目授予对 ALL RESTRICTED APPLICATION PACKAGES 和 ALL APPLICATION PACKAGES 的可继承读取和执行访问权限。 保留运行时文件夹的现有权限。

如何准备

  1. 将 ACL 安装程序添加到安装、运行时更新和修复路径。

  2. 执行每个部署操作后,验证这两个标识是否对运行时文件夹及其内容具有读取和执行访问权限。

  3. 以普通用户身份运行已安装的应用,并练习应用依赖的每一个 WebView2 功能。 仅通过初始页面加载不足以进行验证。

  4. 使用可操作的修复路径处理 WebView2 process-start 或 access-denied 故障。

  5. 请勿使用 no-sandbox 或其他禁用沙盒开关作为解决方法。

了解详细信息

共享反馈

有疑问或遇到部署回归? 在 WebView2Feedback 存储库中提交问题,包括部署模型、运行时路径、Windows 和运行时版本、生成的 ACL 和重现步骤。

即将推出的重大更改:更严格的文件系统访问目录检查

从 v159 开始,WebView2 将在 Windows 上文件系统访问目录遍历期间应用更严格的受限文件夹检查。

当 Web 内容访问或枚举授予目录下的条目时,Windows 上的 WebView2 将通过应用敏感位置检查与 Chromium 安全行为更紧密地保持一致。

此更改可能会影响向 Web 内容公开文件系统访问 API 或委派对受保护系统或配置文件位置下的文件夹的访问权限的应用。 请查看文件访问设计并做出相应的规划。

暂定) 时间线 (发布

  • 2026 年 10 月 - 提前公告。

  • 迁移窗口 — 公告后约 2 个月;最终日期有待发布所有者确认。

  • [需要发布所有者确认] - 更严格的检查会到达 WebView2 预览频道。

  • [需要发布所有者确认] — 强制执行到达 Evergreen Stable 运行时和相应的固定版本版本。

这对应用意味着什么

  • 不使用文件系统访问 API 的应用:

    无需执行任何操作。

  • 枚举用户选择目录的应用:

    链接或受保护的子条目现在可能会返回 access-denied 结果。

  • 故意访问受限位置下方数据的应用:

    直接文件系统访问工作流可能会停止工作,并且需要更改存储或主机集成。

  • 主机委派的工作流:

    查看授予的位置、其子级或任何关联的目标是否属于受限位置政策的范畴。

如何准备

  1. 尽可能将 Web 内容所需的应用托管数据移动到适当的非受限位置。

  2. 如果受保护的数据必须保留在原处,则仅通过经过验证的主机介导接口公开最少的必要操作,而不是广泛的直接文件系统访问。

  3. 优雅地处理拒绝访问的结果,并提供可操作的用户恢复路径。

关于受限制的文件夹

受限位置策略对安全敏感,可能会不断变化。 Microsoft 不会发布或保证目录列表详尽无遗。 不要对文件夹列表进行硬编码,也不要假定某个位置是允许的,因为文档中未命名该位置。 Chromium 的公共指南同样介绍了受限文件夹和示例,但没有发布详尽的阻止列表。

了解详细信息

  • 文件系统访问 API 中的受限文件夹:在 Chrome 文档中简化对本地文件的访问。

共享反馈

有问题或遇到回归? 在 WebView2Feedback 存储库 中提交问题,包括 API 序列、所选文件夹形状、链接路径详细信息、Windows 和运行时版本以及重现步骤。

错误修补程序

  • 限制了 DACL 突变表面。
  • 修复了当前本地用户失败的 Windows 交互式登录尝试。
  • 修复了 WebResourceRequested 服务工作进程和共享辅助角色的事件未正确限定到 WebView2 配置文件的问题。
  • 修复了点击从窗口控件覆盖 (WCO) 标题栏传播到 webcontents 的问题。
  • 修复了最小化模式下不正确的视区。
  • 修复了最小窗口中的 JAWS 支持。
  • 修复了以主机应用的身份(而不是共享运行时的身份)提交以进行防病毒扫描的下载的问题。
  • 修复了 Web 标记提示状态,以便按主机应用而不是共享 WebView2 运行时跟踪。

另请参阅