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
• 使用 2 个新函数扩展了 navigationHistory API，以更好地管理历史记录。 #42014
• 改进了原生主题透明度检查。 #42862

堆栈变化

• Chromium 130.0.6723.44
  • 130 版本的新功能
  • 129 版本的新功能
• Node 20.18.0
  • Node 20.18.0 博客文章
  • Node 20.17.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
• 使用 2 个新函数扩展了 navigationHistory API，以更好地管理历史记录。 #42014

破坏性变更

移除：macOS 10.15 支持

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

旧版本的 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 事件中的 webContents 属性将在使用 respondToAuthRequestsFromMainProcess 选项创建的 实用程序进程 发起请求时为 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 的公共时间线。

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