Electron 29.0.0

Electron 29.0.0 已发布！它包含对 Chromium 122.0.6261.39、V8 12.2 和 Node.js 20.9.0 的升级。

---

Electron 团队很高兴地宣布 Electron 29.0.0 的发布！您可以通过 npm install electron@latest 使用 npm 安装它，或从我们的 发布网站 下载它。继续阅读以了解有关此版本的详细信息。

如果您有任何反馈，请在 Twitter 或 Mastodon 上与我们分享，或加入我们的社区 Discord！错误和功能请求可以在 Electron 的 问题跟踪器 中报告。

值得注意的更改

亮点

• 添加了一个新的顶级 webUtils 模块，这是一个渲染器进程模块，它提供了一个实用层来与 Web API 对象交互。模块中第一个可用的 API 是 webUtils.getPathForFile。Electron 之前的 File.path 增强是与 Web 标准的偏离；这个新 API 更多地符合当前 Web 标准的行为。

堆栈更改

• Chromium 122.0.6261.39
  • 在 Chrome 122 和 DevTools 122 中的新功能
  • 在 Chrome 121 和 DevTools 121 中的新功能
• Node 20.9.0
  • Node 20.9.0 说明
  • Node 20.0.0 说明
• V8 12.2

Electron 29 将 Chromium 从 120.0.6099.56 升级到 122.0.6261.39，将 Node 从 18.18.2 升级到 20.9.0，将 V8 从 12.0 升级到 12.2。

新功能

• 添加了新的 webUtils 模块，这是一个用于与 Web API 对象交互的实用层，用于替换 File.path 增强。 #38776
• 将 net 模块添加到 实用程序进程。 #40890
• 添加了一个新的 Electron 熔断器，grantFileProtocolExtraPrivileges，它将 file:// 协议选择到更安全、更严格的行为，与 Chromium 相匹配。 #40372
• 在 protocol.registerSchemesAsPrivileged 中添加了一个选项，允许在自定义方案中使用 V8 代码缓存。 #40544
• 将 app.{set|get}LoginItemSettings(settings) 迁移到在 macOS 13.0+ 上使用 Apple 新推荐的底层框架。 #37244

重大更改

行为更改：ipcRenderer 无法再通过 contextBridge 发送

尝试通过 contextBridge 将整个 ipcRenderer 模块作为对象发送现在将导致在桥的接收端出现一个空对象。此更改是为了移除/缓解一个安全陷阱。您不应该直接通过桥公开 ipcRenderer 或其方法。相反，请提供一个像下面这样的安全包装器

contextBridge.exposeInMainWorld('app', {
  onEvent: (cb) => ipcRenderer.on('foo', (e, ...args) => cb(args)),
});

移除：app 上的 renderer-process-crashed 事件

app 上的 renderer-process-crashed 事件已被移除。请使用新的 render-process-gone 事件代替。

// Removed
app.on('renderer-process-crashed', (event, webContents, killed) => {
  /* ... */
});

// Replace with
app.on('render-process-gone', (event, webContents, details) => {
  /* ... */
});

移除：WebContents 和 <webview> 上的 crashed 事件

WebContents 和 <webview> 上的 crashed 事件已被移除。请使用新的 render-process-gone 事件代替。

// Removed
win.webContents.on('crashed', (event, killed) => {
  /* ... */
});
webview.addEventListener('crashed', (event) => {
  /* ... */
});

// Replace with
win.webContents.on('render-process-gone', (event, details) => {
  /* ... */
});
webview.addEventListener('render-process-gone', (event) => {
  /* ... */
});

移除：app 上的 gpu-process-crashed 事件

app 上的 gpu-process-crashed 事件已被移除。请使用新的 child-process-gone 事件代替。

// Removed
app.on('gpu-process-crashed', (event, killed) => {
  /* ... */
});

// Replace with
app.on('child-process-gone', (event, details) => {
  /* ... */
});

26.x.y 的支持结束

Electron 26.x.y 已根据项目的 支持策略 结束支持。鼓励开发人员和应用程序升级到 Electron 的更新版本。

E29 (Feb'24)	E30 (Apr'24)	E31 (Jun'24)
29.x.y	30.x.y	31.x.y
28.x.y	29.x.y	30.x.y
27.x.y	28.x.y	29.x.y

下一步

您知道 Electron 最近添加了社区请求意见 (RFC) 流程吗？如果您想向框架添加功能，RFC 可以成为与维护人员就其设计进行对话的有用工具。您还可以查看在拉取请求中讨论的即将发生的更改。要了解更多信息，请查看我们的 介绍 electron/rfcs 博客文章，或直接查看 electron/rfcs 存储库的自述文件。

短期内，团队将继续专注于跟进构成 Electron 的主要组件，包括 Chromium、Node 和 V8 的开发。

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

有关未来更改的更多信息，请访问 计划的重大更改 页面。