跳转到主要内容

Electron 34.0.0

·阅读时长 4 分钟

Electron 34.0.0 已发布!其中包括对 Chromium 132.0.6834.83、V8 13.2 和 Node 20.18.1 的升级。


Electron 团队很高兴地宣布 Electron 34.0.0 正式发布!你可以通过 npm 安装它:npm install electron@latest,或者从我们的发布网站下载。请继续阅读以了解此版本的详细信息。

如果您有任何反馈,请在 BlueskyMastodon 上与我们分享,或加入我们的社区 Discord!Bug 和功能请求可以在 Electron 的 issue 追踪器中报告。

重要变更

HTTP 压缩共享字典管理 API

HTTP 压缩允许数据在被浏览器接收之前由 Web 服务器进行压缩。现代版本的 Chromium 支持 Brotli 和 Zstandard,这两种是较新的压缩算法,在处理文本文件时比 gzip 等旧方案性能更好。

自定义共享字典进一步提高了 Brotli 和 Zstandard 的压缩效率。更多信息,请参阅Chrome for Developers 关于共享字典的博客文章

@felixrieseberg#44950 中添加了以下 API,用于在 Session 级别管理共享字典。

  • session.getSharedDictionaryUsageInfo()
  • session.getSharedDictionaryInfo(options)
  • session.clearSharedDictionaryCache()
  • session.clearSharedDictionaryCacheForIsolationKey(options)

无响应渲染进程的 JavaScript 调用堆栈

当渲染进程卡顿时间过长时,会触发 Electron 的 unresponsive 事件。由 @samuelmaddock#44204 中新增的 WebFrameMain.collectJavaScriptCallStack() API 允许你从相关的 WebFrameMain 对象 (webContnets.mainFrame) 收集 JavaScript 调用堆栈。

当存在导致进程挂起的长时间运行的 JavaScript 事件时,此 API 可用于确定框架无响应的原因。更多信息,请参阅提议的 Web 标准崩溃报告 API

主进程
const { app } = require('electron');

app.commandLine.appendSwitch(
'enable-features',
'DocumentPolicyIncludeJSCallStacksInCrashReports',
);

app.on('web-contents-created', (_, webContents) => {
webContents.on('unresponsive', async () => {
// Interrupt execution and collect call stack from unresponsive renderer
const callStack = await webContents.mainFrame.collectJavaScriptCallStack();
console.log('Renderer unresponsive\n', callStack);
});
});
警告

此 API 要求启用 'Document-Policy': 'include-js-call-stacks-in-crash-reports' 标头。有关更多详细信息,请参阅 #45356

技术栈变更

Electron 34 将 Chromium 从 130.0.6723.44 升级到 132.0.6834.83,Node 从 20.18.0 升级到 20.18.1,V8 从 13.0 升级到 13.2

新特性

  • 新增了用于管理共享字典以提高 Brotli 或 ZStandard 压缩效率的 API。新的 API 是 session.getSharedDictionaryUsageInfo()session.getSharedDictionaryInfo(options)session.clearSharedDictionaryCache()session.clearSharedDictionaryCacheForIsolationKey(options)#44950
  • 添加了 WebFrameMain.collectJavaScriptCallStack() 用于访问无响应渲染器的 JavaScript 调用堆栈。#44938
  • 为处于卸载状态的帧添加了 WebFrameMain.detached
    • 添加了 WebFrameMain.isDestroyed() 以确定帧是否已被销毁。
    • 修复了当框架卸载时,webFrameMain.fromId(processId, frameId) 返回的 WebFrameMain 实例与给定参数不匹配的问题。#43473
  • 在实用程序进程中添加了错误事件,以支持 V8 致命错误的诊断报告。#43774
  • 特性:GPU 加速的共享纹理离屏渲染。#42953

破坏性变更

行为变更:在 Windows 上全屏时将隐藏菜单栏

这使得行为与 Linux 保持一致。之前的行为:在 Windows 上全屏时菜单栏仍然可见。新的行为:在 Windows 上全屏时菜单栏隐藏。

更正:此项先前被列为 Electron 33 中的重大变更,但实际上是在 Electron 34 中首次发布的。

停止支持 31.x.y

根据项目的支持政策,Electron 31.x.y 已停止支持。鼓励开发者和应用程序升级到更新版本的 Electron。

E34 (25年1月)E35 (25年4月)E36 (25年6月)
34.x.y35.x.y36.x.y
33.x.y34.x.y35.x.y
32.x.y33.x.y34.x.y

下一步计划

短期内,您可以预期团队将继续专注于跟进构成 Electron 的主要组件(包括 Chromium、Node 和 V8)的开发。

您可以在此处找到 Electron 的公开时间线

有关未来变更的更多信息,请参阅计划中的破坏性变更页面。