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 使用 npm install electron@latest 命令安装它，或者从我们的 发布网站下载。请继续阅读以了解此版本的详细信息。

如果您有任何反馈，请通过 Twitter 或 Mastodon 与我们分享，或加入我们的社区 Discord！Bug 和功能请求可以在 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 Fuse，`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 (2024年2月)	E30 (2024年4月)	E31 (2024年6月)
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 是一个有用的工具，可以与维护者就其设计展开对话。您还可以在 Pull Request 中查看正在讨论的即将进行的更改。要了解更多信息，请查看我们的 介绍 electron/rfcs 博客文章，或直接查看 electron/rfcs 仓库的 README。

在短期内，您可以期待团队继续专注于跟进构成 Electron 的主要组件（包括 Chromium、Node 和 V8）的开发。

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

有关未来变更的更多信息，请参阅计划的重大变更页面。