Electron 33.0.0
Electron 33.0.0 现已发布！此版本升级到了 Chromium 130.0.6723.44、V8 13.0 和 Node 20.18.0。
Electron 团队很高兴地宣布发布 Electron 33.0.0！您可以通过 npm install electron@latest 使用 npm 进行安装，或者从我们的 发布网站 下载。请继续阅读以获取此版本详情。
如果您有任何反馈，请在 Twitter 或 Mastodon 上与我们分享，或者加入我们的社区 Discord！Bug 和功能请求可以在 Electron 的问题追踪器中报告。
重要变更
亮点
- 添加了一个处理程序
app.setClientCertRequestPasswordHandler(handler)，用于在需要 PIN 码时帮助解锁加密设备。#41205 - 扩展了
navigationHistoryAPI，新增了 2 个函数以实现更好的历史记录管理。#42014 - 改进了原生主题透明度检查。#42862
技术栈变更
- Chromium
130.0.6723.44 - Node
20.18.0 - V8
13.0
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 - 在 utility process 中添加了 error 事件，以支持对 V8 致命错误的诊断报告。#43997
- 添加了
View.setBorderRadius(radius)，用于自定义视图的边框圆角，并兼容WebContentsView。#42320 - 扩展了
navigationHistoryAPI，新增了 2 个函数以实现更好的历史记录管理。#42014
破坏性变更
移除：对 macOS 10.15 的支持
Chromium 不再支持 macOS 10.15 (Catalina)。
旧版本的 Electron 将继续在 Catalina 上运行，但运行 Electron v33.0.0 及更高版本需要 macOS 11 (Big Sur) 或更高版本。
行为变更：原生模块现在需要 C++20
由于上游的变更，V8 和 Node.js 现在都需要 C++20 作为最低版本。使用原生 Node.js 模块的开发者应该使用 --std=c++20 而不是 --std=c++17 来编译他们的模块。使用 gcc9 或更低版本的图像可能需要更新到 gcc10 才能进行编译。有关更多详细信息，请参阅 #43555。
行为变更：Windows 上的自定义协议 URL 处理
由于 Chromium 进行了变更以支持 非特殊方案 URL，使用 Windows 文件路径的自定义协议 URL 将不再能正确地与已弃用的 protocol.registerFileProtocol 以及 BrowserWindow.loadURL、WebContents.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');
行为变更：`app` 的 `login` 事件上的 `webContents` 属性
当 `app` 的 `login` 事件由使用 respondToAuthRequestsFromMainProcess 选项创建的 utility process 触发请求时，`webContents` 属性将为 null。
已弃用：BrowserWindowConstructorOption.type 中的 textured 选项
BrowserWindowConstructorOptions 中 type 的 textured 选项已被弃用，没有替代方案。该选项依赖于 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.y | 34.x.y | 35.x.y |
| 32.x.y | 33.x.y | 34.x.y |
| 31.x.y | 32.x.y | 33.x.y |
下一步计划
短期内，您可以预期团队将继续专注于跟进构成 Electron 的主要组件（包括 Chromium、Node 和 V8）的开发。
您可以在此处找到 Electron 的公开时间线。
有关未来变更的更多信息，请参阅计划中的破坏性变更页面。
