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 的 问题跟踪器 中报告 bug 和功能请求。

重要变更

亮点

• 添加了一个新的顶级 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
• 在 macOS 13.0+ 上，已将 app.{set|get}LoginItemSettings(settings) 迁移到使用 Apple 新推荐的底层框架。 #37244

破坏性变更

行为变更：ipcRenderer 不再可以通过 contextBridge 发送

尝试将整个 ipcRenderer 模块作为一个对象通过 contextBridge 发送，现在将在桥的接收端得到一个空对象。此更改是为了移除/缓解一个安全隐患。您不应直接在桥上暴露 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 (24年2月)	E30 (24年4月)	E31 (24年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 可以成为与维护者就其设计展开对话的有用工具。您还可以通过查看“拉取请求”来了解即将进行的更改。要了解更多信息，请查看我们的 Introducing electron/rfcs 博客文章，或直接查看 electron/rfcs 仓库的 README。

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

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

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