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！错误和功能请求可以在 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 代码缓存。
• 在 macOS 13.0+ 上，将 app.{set|get}LoginItemSettings(settings) 迁移到使用 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 (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 可以是一个有用的工具，可以与维护者讨论其设计。您还可以查看正在 Pull Requests 中讨论的即将到来的更改。要了解更多信息，请查看我们的 Introducing electron/rfcs 博客文章，或直接查看 electron/rfcs 仓库的 README。

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

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

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