跳到主要内容

Electron 33.0.0

·4 分钟阅读

Electron 33.0.0 已发布!它包括 Chromium 130.0.6723.44、V8 13.0 和 Node 20.18.0 的升级。


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

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

值得注意的更改

亮点

  • 添加了一个处理程序 app.setClientCertRequestPasswordHandler(handler),以帮助在需要 PIN 码时解锁加密设备。 #41205
  • 扩展了 navigationHistory API,增加了 2 个新功能,以实现更好的历史记录管理。 #42014
  • 改进了原生主题透明度检查。 #42862

堆栈更改

Electron 33 将 Chromium 从 128.0.6613.36 升级到 130.0.6723.44,将 Node 从 20.16.0 升级到 20.18.0,并将 V8 从 12.8 升级到 13.0

新功能

  • 添加了一个处理程序 app.setClientCertRequestPasswordHandler(handler),以帮助在需要 PIN 码时解锁加密设备。 #41205
  • 在实用程序进程中添加了错误事件,以支持 V8 致命错误的诊断报告。 #43997
  • 添加了 View.setBorderRadius(radius) 用于自定义视图的边框半径,并兼容 WebContentsView#42320
  • 扩展了 navigationHistory API,增加了 2 个新功能,以实现更好的历史记录管理。 #42014

重大更改

已移除:macOS 10.15 支持

macOS 10.15 (Catalina) 不再受 Chromium 支持。

旧版本的 Electron 将继续在 Catalina 上运行,但 macOS 11 (Big Sur) 或更高版本将是运行 Electron v33.0.0 及更高版本所必需的。

行为已更改:原生模块现在需要 C++20

由于上游所做的更改,V8Node.js 现在都需要 C++20 作为最低版本。使用原生 node 模块的开发人员应使用 --std=c++20 而不是 --std=c++17 构建其模块。使用 gcc9 或更低版本的映像可能需要更新到 gcc10 才能编译。有关更多详细信息,请参阅 #43555

行为已更改:Windows 上的自定义协议 URL 处理

由于 Chromium 中为支持 非特殊方案 URL 所做的更改,使用 Windows 文件路径的自定义协议 URL 将不再与已弃用的 protocol.registerFileProtocol 以及 BrowserWindow.loadURLWebContents.loadURL<webview>.loadURL 上的 baseURLForDataURL 属性正确工作。protocol.handle 也将不适用于这些类型的 URL,但这并不是一项更改,因为它一直都是这样工作的。

// No longer works
protocol.registerFileProtocol('other', () => {
callback({ filePath: '/path/to/my/file' });
});

const mainWindow = new BrowserWindow();
mainWindow.loadURL(
'data:text/html,<script src="loaded-from-dataurl.js"></script>',
{ baseURLForDataURL: 'other://C:\\myapp' },
);
mainWindow.loadURL('other://C:\\myapp\\index.html');

// Replace with
const path = require('node:path');
const nodeUrl = require('node:url');
protocol.handle(other, (req) => {
const srcPath = 'C:\\myapp\\';
const reqURL = new URL(req.url);
return net.fetch(
nodeUrl.pathToFileURL(path.join(srcPath, reqURL.pathname)).toString(),
);
});

mainWindow.loadURL(
'data:text/html,<script src="loaded-from-dataurl.js"></script>',
{ baseURLForDataURL: 'other://' },
);
mainWindow.loadURL('other://index.html');

行为已更改:applogin 上的 webContents 属性

当为来自使用 respondToAuthRequestsFromMainProcess 选项创建的 实用程序进程 的请求触发事件时,来自 applogin 事件中的 webContents 属性将为 null

已弃用:BrowserWindowConstructorOption.type 中的 textured 选项

BrowserWindowConstructorOptionstypetextured 选项已被弃用,没有替代品。此选项依赖于 macOS 上的 NSWindowStyleMaskTexturedBackground 样式掩码,该掩码已被弃用,没有替代方案。

已弃用:systemPreferences.accessibilityDisplayShouldReduceTransparency

systemPreferences.accessibilityDisplayShouldReduceTransparency 属性现在已被弃用,取而代之的是新的 nativeTheme.prefersReducedTransparency,后者提供相同的信息并且可以跨平台工作。

// Deprecated
const shouldReduceTransparency =
systemPreferences.accessibilityDisplayShouldReduceTransparency;

// Replace with:
const prefersReducedTransparency = nativeTheme.prefersReducedTransparency;

30.x.y 版本停止支持

根据项目的支持策略,Electron 30.x.y 已达到停止支持的期限。鼓励开发人员和应用程序升级到较新版本的 Electron。

E33 (24 年 10 月)E34 (25 年 1 月)E35 (25 年 4 月)
33.x.y34.x.y35.x.y
32.x.y33.x.y34.x.y
31.x.y32.x.y33.x.y

下一步是什么

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

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

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