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 使用 npm install electron@latest
安装它,也可以从我们的 发布网站 下载它。继续阅读以了解有关此版本的详细信息。
如果您有任何反馈,请在 Twitter 或 Mastodon 上与我们分享,或加入我们的社区 Discord!错误和功能请求可以在 Electron 的 问题跟踪器 中报告。
值得注意的更改
亮点
- 添加了一个处理程序,
app.setClientCertRequestPasswordHandler(handler)
,以帮助在需要 PIN 时解锁加密设备。 #41205 - 使用两个新函数扩展了
navigationHistory
API,以更好地管理历史记录。 #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 - 在实用程序进程中添加了错误事件,以支持 V8 致命错误的诊断报告。 #43997
- 添加了
View.setBorderRadius(radius)
用于自定义视图的边框半径 - 与WebContentsView
兼容。 #42320 - 使用两个新函数扩展了
navigationHistory
API,以更好地管理历史记录。 #42014
重大变更
移除:macOS 10.15 支持
macOS 10.15 (Catalina) 不再受 Chromium 支持。
较旧版本的 Electron 将继续在 Catalina 上运行,但需要 macOS 11 (Big Sur) 或更高版本才能运行 Electron v33.0.0 及更高版本。
行为变更:原生模块现在需要 C++20
由于上游进行的更改,V8 和 Node.js 现在都将 C++20 作为最低版本要求。使用原生节点模块的开发人员应该使用 --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
属性
当从使用 respondToAuthRequestsFromMainProcess
选项创建的 实用程序进程 中的请求触发事件时,来自 app
的 login
事件中的 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 (2024 年 10 月) | E34 (2025 年 1 月) | E35 (2025 年 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 的公开时间线。
有关未来更改的更多信息,请参阅 计划的重大更改 页面。