跳至主要内容

45 篇标记为“发布”的文章

关于新 Electron 版本的博客文章

查看所有标签

Electron 27.0.0

·4 分钟阅读

Electron 27.0.0 已经发布!它包括升级到 Chromium 118.0.5993.32、V8 11.8 和 Node.js 18.17.1


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

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

值得注意的变化

堆栈变化

重大更改

已删除:macOS 10.13 / 10.14 支持

macOS 10.13 (High Sierra) 和 macOS 10.14 (Mojave) 不再受 Chromium 支持。

旧版本的 Electron 将继续在这些操作系统上运行,但需要 macOS 10.15 (Catalina) 或更高版本才能运行 Electron v27.0.0 及更高版本。

已弃用:ipcRenderer.sendTo()

ipcRenderer.sendTo() API 已被弃用。它应该被替换为在渲染器之间设置一个 MessageChannel

IpcRendererEventsenderIdsenderIsMainFrame 属性也被弃用。

已删除:systemPreferences 中的颜色方案事件

以下 systemPreferences 事件已被删除

  • inverted-color-scheme-changed
  • high-contrast-color-scheme-changed

请改用 nativeTheme 模块上的新 updated 事件。

// Removed
systemPreferences.on('inverted-color-scheme-changed', () => {
/* ... */
});
systemPreferences.on('high-contrast-color-scheme-changed', () => {
/* ... */
});

// Replace with
nativeTheme.on('updated', () => {
/* ... */
});

已删除:webContents.getPrinters

webContents.getPrinters 方法已被删除。请改用 webContents.getPrintersAsync

const w = new BrowserWindow({ show: false });

// Removed
console.log(w.webContents.getPrinters());
// Replace with
w.webContents.getPrintersAsync().then((printers) => {
console.log(printers);
});

已删除:systemPreferences.{get,set}AppLevelAppearancesystemPreferences.appLevelAppearance

systemPreferences.getAppLevelAppearancesystemPreferences.setAppLevelAppearance 方法已被删除,以及 systemPreferences.appLevelAppearance 属性。请改用 nativeTheme 模块。

// Removed
systemPreferences.getAppLevelAppearance();
// Replace with
nativeTheme.shouldUseDarkColors;

// Removed
systemPreferences.appLevelAppearance;
// Replace with
nativeTheme.shouldUseDarkColors;

// Removed
systemPreferences.setAppLevelAppearance('dark');
// Replace with
nativeTheme.themeSource = 'dark';

已删除:systemPreferences.getColoralternate-selected-control-text

systemPreferences.getColoralternate-selected-control-text 值已被删除。请改用 selected-content-background

// Removed
systemPreferences.getColor('alternate-selected-control-text');
// Replace with
systemPreferences.getColor('selected-content-background');

新功能

  • 添加了应用程序辅助功能透明度设置 api #39631
  • 添加了对 chrome.scripting 扩展 API 的支持 #39675
  • 默认启用 WaylandWindowDecorations #39644

24.x.y 的支持结束

根据该项目的 支持政策,Electron 24.x.y 已达到支持的终点。鼓励开发人员和应用程序升级到较新版本的 Electron。

E27 (23 年 10 月)E28 (23 年 12 月)E29 (24 年 2 月)
27.x.y28.x.y29.x.y
26.x.y27.x.y28.x.y
25.x.y26.x.y27.x.y

22.x.y 的扩展支持结束

今年早些时候,Electron 团队将 Electron 22 计划的生命周期结束日期从 2023 年 5 月 30 日延长到 2023 年 10 月 10 日,以便与 Chrome 对 Windows 7/8/8.1 的扩展支持相匹配(有关更多详细信息,请参阅 告别 Windows 7/8/8.1)。

根据该项目的 支持政策 和此支持扩展,Electron 22.x.y 已达到支持的终点。这将使支持恢复到最新的三个稳定主要版本,并将结束对 Windows 7/8/8.1 的官方支持。

下一步是什么

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

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

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

Electron 26.0.0

·3 分钟阅读

Electron 26.0.0 已经发布!它包括升级到 Chromium 116.0.5845.62、V8 11.2 和 Node.js 18.16.1。请阅读以下内容以了解更多详细信息!


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

如果您有任何反馈,请在 Twitter 上与我们分享,或者加入我们的社区 Discord!错误和功能请求可以在 Electron 的 问题跟踪器 中报告。

值得注意的变化

堆栈变化

重大更改

已弃用:webContents.getPrinters

webContents.getPrinters 方法已被弃用。请改用 webContents.getPrintersAsync

const w = new BrowserWindow({ show: false });

// Deprecated
console.log(w.webContents.getPrinters());
// Replace with
w.webContents.getPrintersAsync().then((printers) => {
console.log(printers);
});

已弃用:systemPreferences.{get,set}AppLevelAppearancesystemPreferences.appLevelAppearance

systemPreferences.getAppLevelAppearancesystemPreferences.setAppLevelAppearance 方法已被弃用,以及 systemPreferences.appLevelAppearance 属性。请改用 nativeTheme 模块。

// Deprecated
systemPreferences.getAppLevelAppearance();
// Replace with
nativeTheme.shouldUseDarkColors;

// Deprecated
systemPreferences.appLevelAppearance;
// Replace with
nativeTheme.shouldUseDarkColors;

// Deprecated
systemPreferences.setAppLevelAppearance('dark');
// Replace with
nativeTheme.themeSource = 'dark';

已弃用:systemPreferences.getColoralternate-selected-control-text

systemPreferences.getColoralternate-selected-control-text 值已被弃用。请改用 selected-content-background

// Deprecated
systemPreferences.getColor('alternate-selected-control-text');
// Replace with
systemPreferences.getColor('selected-content-background');

新功能

  • 添加了 safeStorage.setUsePlainTextEncryptionsafeStorage.getSelectedStorageBackend api。 #39107
  • 添加了 safeStorage.setUsePlainTextEncryptionsafeStorage.getSelectedStorageBackend api。 #39155
  • 向通过 ipcRenderer.sendTo() 发送的消息添加了 senderIsMainFrame#39206
  • 添加了对将菜单标记为键盘启动的支持。 #38954

23.x.y 的支持结束

根据该项目的 支持政策,Electron 23.x.y 已达到支持的终点。鼓励开发人员和应用程序升级到较新版本的 Electron。

E26 (23 年 8 月)E27 (23 年 10 月)E28 (24 年 1 月)
26.x.y27.x.y28.x.y
25.x.y26.x.y27.x.y
24.x.y25.x.y26.x.y
22.x.y

下一步是什么

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

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

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

Electron 25.0.0

·5 分钟阅读

Electron 25.0.0 已经发布!它包括升级到 Chromium 114、V8 11.4 和 Node.js 18.15.0。请阅读以下内容以了解更多详细信息!


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

如果您有任何反馈,请在 Twitter 上与我们分享,或者加入我们的社区 Discord!错误和功能请求可以在 Electron 的 问题跟踪器 中报告。

值得注意的变化

亮点

  • 在 Electron 的 net 模块中实现了 net.fetch,使用 Chromium 的网络堆栈。这与使用 Node.js 的 HTTP 堆栈的 Node 的 fetch() 不同。请参阅 #36733#36606
  • 添加了 protocol.handle,它取代并弃用了 protocol.{register,intercept}{String,Buffer,Stream,Http,File}Protocol#36674
  • 延长了对 Electron 22 的支持,以便与 Chromium 和 Microsoft 的 Windows 7/8/8.1 弃用计划相匹配。请参阅此博客文章末尾的其他详细信息。

堆栈变化

重大更改

已弃用: protocol.{register,intercept}{Buffer,String,Stream,File,Http}Protocol

protocol.register*Protocolprotocol.intercept*Protocol 方法已被 protocol.handle 替代。

新方法既可以注册新的协议,也可以拦截现有的协议,并且响应可以是任何类型。

// Deprecated in Electron 25
protocol.registerBufferProtocol('some-protocol', () => {
callback({ mimeType: 'text/html', data: Buffer.from('<h5>Response</h5>') });
});

// Replace with
protocol.handle('some-protocol', () => {
return new Response(
Buffer.from('<h5>Response</h5>'), // Could also be a string or ReadableStream.
{ headers: { 'content-type': 'text/html' } },
);
});
// Deprecated in Electron 25
protocol.registerHttpProtocol('some-protocol', () => {
callback({ url: 'https://electron.js.cn' });
});

// Replace with
protocol.handle('some-protocol', () => {
return net.fetch('https://electron.js.cn');
});
// Deprecated in Electron 25
protocol.registerFileProtocol('some-protocol', () => {
callback({ filePath: '/path/to/my/file' });
});

// Replace with
protocol.handle('some-protocol', () => {
return net.fetch('file:///path/to/my/file');
});

已弃用: BrowserWindow.setTrafficLightPosition(position)

BrowserWindow.setTrafficLightPosition(position) 已被弃用,应该使用 BrowserWindow.setWindowButtonPosition(position) API 来代替,它接受 null 而不是 { x: 0, y: 0 } 来将位置重置为系统默认值。

// Deprecated in Electron 25
win.setTrafficLightPosition({ x: 10, y: 10 });
win.setTrafficLightPosition({ x: 0, y: 0 });

// Replace with
win.setWindowButtonPosition({ x: 10, y: 10 });
win.setWindowButtonPosition(null);

已弃用: BrowserWindow.getTrafficLightPosition()

BrowserWindow.getTrafficLightPosition() 已被弃用,应该使用 BrowserWindow.getWindowButtonPosition() API 来代替,当没有自定义位置时,它会返回 null 而不是 { x: 0, y: 0 }

// Deprecated in Electron 25
const pos = win.getTrafficLightPosition();
if (pos.x === 0 && pos.y === 0) {
// No custom position.
}

// Replace with
const ret = win.getWindowButtonPosition();
if (ret === null) {
// No custom position.
}

新功能

  • 添加了 net.fetch()#36733
    • net.fetch 支持对 file: URL 以及使用 protocol.register*Protocol 注册的自定义协议的请求。 #36606
  • 添加了 BrowserWindow.set/getWindowButtonPosition APIs。 #37094
  • 添加了 protocol.handle,替换并弃用了 protocol.{register,intercept}{String,Buffer,Stream,Http,File}Protocol#36674
  • webContents<webview> 标签添加了 will-frame-navigate 事件,每当帧层级结构中的任何帧尝试导航时,都会触发该事件。 #34418
  • 将启动器信息添加到 navigator 事件。 此信息允许区分 window.open 是由父框架引起的导航,还是由子级发起的导航。 #37085
  • 添加了使用 defaultSession 对象解析主机的 net.resolveHost。 #38152
  • app 添加了新的 'did-resign-active' 事件。 #38018
  • webContents.print() 添加了几个标准页面尺寸选项。 #37159
  • enableLocalEcho 标志添加到会话处理程序 ses.setDisplayMediaRequestHandler() 回调,以允许在 audioWebFrameMain 时,远程音频输入在本地输出流中回显。 #37315
  • 将热管理信息添加到 powerMonitor#38028
  • 允许将绝对路径传递给 session.fromPath() API。 #37604
  • webContents 上公开了 audio-state-changed 事件。 #37366

22.x.y 继续支持

告别,Windows 7/8/8.1 中所述,Electron 22 (Chromium 108) 计划的生命周期结束日期将从 2023 年 5 月 30 日延长至 2023 年 10 月 10 日。 Electron 团队将继续将此程序中的任何安全修复程序向后移植到 Electron 22,直到 2023 年 10 月 10 日。 10 月份的支持日期与 Chromium 和 Microsoft 的扩展支持日期一致。 10 月 11 日,Electron 团队将放弃对最新三个稳定主要版本的支持,这些版本将不再支持 Windows 7/8/8.1。

E25 (23 年 5 月)E26 (23 年 8 月)E27 (23 年 10 月)
25.x.y26.x.y27.x.y
24.x.y25.x.y26.x.y
23.x.y24.x.y25.x.y
22.x.y22.x.y--

下一步是什么

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

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

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

Electron 24.0.0

·4 分钟阅读

Electron 24.0.0 已发布! 它包括 Chromium 112.0.5615.49、V8 11.2 和 Node.js 18.14.0 的升级。 阅读下文了解更多详情!


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

如果您有任何反馈,请在 Twitter 上与我们分享,或者加入我们的社区 Discord!错误和功能请求可以在 Electron 的 问题跟踪器 中报告。

值得注意的变化

堆栈变化

重大更改

API 更改: nativeImage.createThumbnailFromPath(path, size)

maxSize 参数已更改为 size,以反映传入的大小将是创建的缩略图的大小。 以前,如果图像小于 maxSize,Windows 不会放大图像,并且 macOS 始终会将大小设置为 maxSize。 现在,各个平台上的行为相同。

// a 128x128 image.
const imagePath = path.join('path', 'to', 'capybara.png');

// Scaling up a smaller image.
const upSize = { width: 256, height: 256 };
nativeImage.createThumbnailFromPath(imagePath, upSize).then((result) => {
console.log(result.getSize()); // { width: 256, height: 256 }
});

// Scaling down a larger image.
const downSize = { width: 64, height: 64 };
nativeImage.createThumbnailFromPath(imagePath, downSize).then((result) => {
console.log(result.getSize()); // { width: 64, height: 64 }
});

新功能

  • 添加了使用 cookies.get() 过滤 HttpOnly cookie 的功能。 #37365
  • logUsage 添加到 shell.openExternal() 选项,这允许将 SEE_MASK_FLAG_LOG_USAGE 标志传递给 Windows 上的 ShellExecuteExSEE_MASK_FLAG_LOG_USAGE 标志指示用户启动的启动,该启动允许跟踪常用程序和其他行为。 #37291
  • types 添加到 webRequest 过滤器,从而可以过滤您侦听的请求。#37427
  • webContents 添加了一个新的 devtools-open-url 事件,以允许开发人员使用它们打开新窗口。 #36774
  • webContents.print() 添加了几个标准页面尺寸选项。 #37265
  • enableLocalEcho 标志添加到会话处理程序 ses.setDisplayMediaRequestHandler() 回调,以允许在 audioWebFrameMain 时,远程音频输入在本地输出流中回显。 #37528
  • 允许将特定于应用程序的用户名传递给 inAppPurchase.purchaseProduct()#35902
  • 公开了 window.invalidateShadow() 以清除 macOS 上的残留视觉伪影。 #32452
  • 默认情况下,现在在 electron 节点头文件配置文件中启用了整个程序优化,允许编译器使用来自程序中所有模块的信息(而不是每个模块(编译单元))来执行优化。 #36937
  • SystemPreferences::CanPromptTouchID (macOS) 现在支持 Apple Watch。 #36935

结束对 21.x.y 的支持

根据项目的支持政策,Electron 21.x.y 已达到支持的终点。 鼓励开发人员和应用程序升级到较新版本的 Electron。

告别,Windows 7/8/8.1 中所述,Electron 22 (Chromium 108) 计划的生命周期结束日期将从 2023 年 5 月 30 日延长至 2023 年 10 月 10 日。 Electron 团队将继续将此程序中的任何安全修复程序向后移植到 Electron 22,直到 2023 年 10 月 10 日。

E24(23 年 4 月)E25 (23 年 5 月)E26 (23 年 8 月)
24.x.y25.x.y26.x.y
23.x.y24.x.y25.x.y
22.x.y23.x.y24.x.y
--22.x.y22.x.y

下一步是什么

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

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

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

Electron 23.0.0

·4 分钟阅读

Electron 23.0.0 已发布! 它包括 Chromium 110、V8 11.0 和 Node.js 18.12.1 的升级。 此外,已删除对 Windows 7/8/8.1 的支持。 阅读下文了解更多详情!


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

如果您有任何反馈,请在 Twitter 上与我们分享,或者加入我们的社区 Discord!错误和功能请求可以在 Electron 的 问题跟踪器 中报告。

值得注意的变化

堆栈变化

新功能

  • label 属性添加到 Display 对象。 #36933
  • 添加了一个 app.getPreferredSystemLanguages() API 以返回用户的系统语言。 #36035
  • 增加了对 WebUSB API 的支持。 #36289
  • 增加了对 SerialPort.forget() 的支持,以及当给定 origin 被撤销时,在 Session 对象上发出新的事件 serial-port-revoked#35310
  • 添加了新的 win.setHiddenInMissionControl API,允许开发人员选择退出 macOS 上的 Mission Control。 #36092

放弃对 Windows 7/8/8.1 的支持

Electron 23 不再支持 Windows 7/8/8.1。 Electron 遵循计划的 Chromium 弃用政策,该政策将在 Chromium 109 中弃用 Windows 7/8/8.1 以及 Windows Server 2012 和 2012 R2 支持(在此处阅读更多内容)

破坏性 API 更改

以下是 Electron 23 中引入的重大更改。 您可以在计划的重大更改页面上阅读有关这些更改和未来更改的更多信息。

已删除: BrowserWindow scroll-touch-* 事件

BrowserWindow 上已弃用的 scroll-touch-beginscroll-touch-endscroll-touch-edge 事件已被删除。 请改用 WebContents 上新提供的 input-event 事件。

// Removed in Electron 23.0
-win.on('scroll-touch-begin', scrollTouchBegin)
-win.on('scroll-touch-edge', scrollTouchEdge)
-win.on('scroll-touch-end', scrollTouchEnd)

// Replace with
+win.webContents.on('input-event', (_, event) => {
+ if (event.type === 'gestureScrollBegin') {
+ scrollTouchBegin()
+ } else if (event.type === 'gestureScrollUpdate') +{
+ scrollTouchEdge()
+ } else if (event.type === 'gestureScrollEnd') {
+ scrollTouchEnd()
+ }
+})

结束对 20.x.y 的支持

根据项目的支持政策,Electron 20.x.y 已达到支持的终点。 鼓励开发人员和应用程序升级到较新版本的 Electron。

E22 (22 年 11 月)E23 (23 年 2 月)E24(23 年 4 月)E25 (23 年 5 月)E26 (23 年 8 月)
22.x.y23.x.y24.x.y25.x.y26.x.y
21.x.y22.x.y23.x.y24.x.y25.x.y
20.x.y21.x.y22.x.y23.x.y24.x.y

下一步是什么

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

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

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

Electron 22.0.0

·6 分钟阅读

Electron 22.0.0 已发布! 它包括一个新的实用程序进程 API、Windows 7/8/8.1 支持的更新以及 Chromium 108、V8 10.8 和 Node.js 16.17.1 的升级。 阅读下文了解更多详情!


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

如果您有任何反馈,请在 Twitter 上与我们分享,或者加入我们的社区 Discord!错误和功能请求可以在 Electron 的 问题跟踪器 中报告。

值得注意的变化

堆栈变化

突出显示的功能

UtilityProcess API #36089

新的 UtilityProcess 主进程模块允许创建一个轻量级的 Chromium 子进程,该子进程仅具有 Node.js 集成,同时还允许使用 MessageChannel 与沙盒渲染器进行通信。 该 API 基于 Node.js child_process.fork 设计,以便于过渡,主要区别在于入口点 modulePath 必须来自打包的应用程序中,以仅允许加载受信任的脚本。 此外,该模块默认情况下会阻止与渲染器建立通信通道,从而维护了主进程是应用程序中唯一受信任进程的约定。

您可以在我们的文档中阅读有关新的 UtilityProcess API 的更多信息

Windows 7/8/8.1 支持更新

信息

2023/02/16: 关于 Windows Server 2012 支持的更新

上个月,Google 宣布 Chrome 109 将继续接收 Windows Server 2012 和 Windows Server 2012 R2 的关键安全修复程序,直到 2023 年 10 月 10 日。 相应地,Electron 22 (Chromium 108) 计划的生命周期结束日期将从 2023 年 5 月 30 日延长至 2023 年 10 月 10 日。 Electron 团队将继续将此程序中的任何安全修复程序向后移植到 Electron 22,直到 2023 年 10 月 10 日。

请注意,我们不会为 Windows 7/8/8.1 进行其他安全修复。 此外,Electron 23 (Chromium 110) 将仅在 Windows 10 及更高版本上运行,如先前宣布的那样。

Electron 22 将是最后一个支持 Windows 7/8/8.1 的 Electron 主要版本。 Electron 遵循计划的 Chromium 弃用政策,该政策将在 Chromium 109 中弃用 Windows 7/8/8.1 支持(在此处阅读更多内容)

Electron 23 及更高版本将不支持 Windows 7/8/8.1。

其他突出显示的更改

  • 增加了对 Linux 和 Windows 上 Web 蓝牙引脚配对的支持。 #35416
  • 添加了 LoadBrowserProcessSpecificV8Snapshot 作为一个新的 fuse,这将允许主进程/浏览器进程从 browser_v8_context_snapshot.bin 文件加载其 v8 快照。 任何其他进程将使用与今天使用的相同的路径。 #35266
  • 添加了 WebContents.opener 以访问窗口开启者,以及 webContents.fromFrame(frame) 以获取与 WebFrameMain 实例对应的 WebContents。 #35140
  • 通过新的会话处理程序 ses.setDisplayMediaRequestHandler 添加了对 navigator.mediaDevices.getDisplayMedia 的支持。 #30702

破坏性 API 更改

以下是 Electron 22 中引入的重大更改。 您可以在计划的重大更改页面上阅读有关这些更改和未来更改的更多信息。

已弃用: webContents.incrementCapturerCount(stayHidden, stayAwake)

webContents.incrementCapturerCount(stayHidden, stayAwake) 已被弃用。 现在,当页面捕获完成时,它由 webContents.capturePage 自动处理。

const w = new BrowserWindow({ show: false })

- w.webContents.incrementCapturerCount()
- w.capturePage().then(image => {
- console.log(image.toDataURL())
- w.webContents.decrementCapturerCount()
- })

+ w.capturePage().then(image => {
+ console.log(image.toDataURL())
+ })

已弃用: webContents.decrementCapturerCount(stayHidden, stayAwake)

webContents.decrementCapturerCount(stayHidden, stayAwake) 已被弃用。 现在,当页面捕获完成时,它由 webContents.capturePage 自动处理。

const w = new BrowserWindow({ show: false })

- w.webContents.incrementCapturerCount()
- w.capturePage().then(image => {
- console.log(image.toDataURL())
- w.webContents.decrementCapturerCount()
- })

+ w.capturePage().then(image => {
+ console.log(image.toDataURL())
+ })

已删除: WebContents new-window 事件

WebContents 的 new-window 事件已被删除。 它被 webContents.setWindowOpenHandler() 取代。

- webContents.on('new-window', (event) => {
- event.preventDefault()
- })

+ webContents.setWindowOpenHandler((details) => {
+ return { action: 'deny' }
+ })

已弃用: BrowserWindow scroll-touch-* 事件

BrowserWindow 上的 scroll-touch-beginscroll-touch-endscroll-touch-edge 事件已被弃用。 请改用 WebContents 上新提供的 input-event 事件

// Deprecated
- win.on('scroll-touch-begin', scrollTouchBegin)
- win.on('scroll-touch-edge', scrollTouchEdge)
- win.on('scroll-touch-end', scrollTouchEnd)

// Replace with
+ win.webContents.on('input-event', (_, event) => {
+ if (event.type === 'gestureScrollBegin') {
+ scrollTouchBegin()
+ } else if (event.type === 'gestureScrollUpdate') {
+ scrollTouchEdge()
+ } else if (event.type === 'gestureScrollEnd') {
+ scrollTouchEnd()
+ }
+ })

结束对 19.x.y 的支持

根据项目的支持政策,Electron 19.x.y 已达到支持的终点。 鼓励开发人员和应用程序升级到较新版本的 Electron。

E19 (22 年 5 月)E20 (22 年 8 月)E21 (22 年 9 月)E22 (22 年 11 月)E23 (23 年 1 月)
19.x.y20.x.y21.x.y22.x.y23.x.y
18.x.y19.x.y20.x.y21.x.y22.x.y
17.x.y18.x.y19.x.y20.x.y21.x.y

下一步是什么

Electron 项目将在 2022 年 12 月暂停一个月,并于 2023 年 1 月恢复。 更多信息请参见 十二月关闭博客文章

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

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

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

Electron 21.0.0

·3 分钟阅读

Electron 21.0.0 已发布!它包括 Chromium 106、V8 10.6 和 Node.js 16.16.0 的升级。请阅读下文了解更多详情!


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

如果您有任何反馈,请在 Twitter 上与我们分享,或者加入我们的社区 Discord!错误和功能请求可以在 Electron 的 问题跟踪器 中报告。

值得注意的变化

堆栈变化

新功能

  • 添加了 webFrameMain.origin#35534
  • 添加了新的 WebContents.ipcWebFrameMain.ipc API。#35231
  • 添加了对类似面板行为的支持。窗口可以浮动在全屏应用程序之上。#34388
  • 添加了对 macOS 应用程序来自 APNs 的推送通知的支持。#33574

重大变更和 API 变更

以下是 Electron 21 中引入的重大变更。

启用 V8 内存笼

Electron 21 启用了 V8 沙盒指针,紧随 Chrome 在 Chrome 103 中采取相同措施之后。这对原生模块有一些影响。此功能具有性能和安全优势,但对原生模块也施加了一些新的限制,例如,使用指向外部(“堆外”)内存的 ArrayBuffer。有关更多信息,请参阅 此博客文章#34724

重构 webContents.printToPDF

重构了 webContents.printToPDF 以与 Chromium 的无头实现保持一致。有关更多信息,请参阅 #33654

有关这些及未来变更的更多信息,请参见 计划的重大变更 页面。

结束对 18.x.y 的支持

根据该项目的 支持策略,Electron 18.x.y 已停止支持。 建议开发人员和应用程序升级到较新版本的 Electron。

E18 (2022年3月)E19 (22 年 5 月)E20 (22 年 8 月)E21 (22 年 9 月)E22 (2022年12月)
18.x.y19.x.y20.x.y21.x.y22.x.y
17.x.y18.x.y19.x.y20.x.y21.x.y
16.x.y17.x.y18.x.y19.x.y20.x.y

下一步是什么

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

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

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

Electron 20.0.0

·4 分钟阅读

Electron 20.0.0 已发布!它包括 Chromium 104、V8 10.4 和 Node.js 16.15.0 的升级。请阅读下文了解更多详情!


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

值得注意的变化

新功能

  • 在 Windows 上添加了沉浸式深色模式。#34549
  • 添加了对类似面板行为的支持。窗口可以浮动在全屏应用程序之上。#34665
  • 更新了 Windows 控制叠加按钮,使其在 Windows 11 上看起来和感觉更原生。#34888
  • 现在,渲染器默认情况下会被沙盒化,除非指定 nodeIntegration: truesandbox: false#35125
  • 在使用 nan 构建原生模块时添加了保护措施。#35160

堆栈变化

重大变更和 API 变更

以下是 Electron 20 中引入的重大变更。有关这些及未来变更的更多信息,请参见 计划的重大变更 页面。

默认更改:没有 nodeIntegration: true 的渲染器默认情况下会被沙盒化

以前,指定预加载脚本的渲染器默认情况下不会被沙盒化。这意味着默认情况下,预加载脚本可以访问 Node.js。在 Electron 20 中,此默认值已更改。从 Electron 20 开始,渲染器默认情况下会被沙盒化,除非指定 nodeIntegration: truesandbox: false

如果您的预加载脚本不依赖于 Node,则无需采取任何操作。如果您的预加载脚本确实依赖于 Node,则可以重构它们以从渲染器中删除 Node 用法,或者为相关渲染器显式指定 sandbox: false

已修复:nan 原生模块中自发崩溃

在 Electron 20 中,我们更改了与原生模块相关的两个项目

  1. V8 标头现在默认使用 c++17。此标志已添加到 electron-rebuild。
  2. 我们修复了一个问题,即缺少 include 会导致依赖于 nan 的原生模块中自发崩溃。

为了获得最佳稳定性,我们建议在重建原生模块时使用 node-gyp >=8.4.0 和 electron-rebuild >=3.2.9,特别是依赖于 nan 的模块。 有关更多信息,请参见 electron #35160 和 node-gyp #2497

已移除:Linux 上的 .skipTaskbar

在 X11 上,skipTaskbar 向 X11 窗口管理器发送 _NET_WM_STATE_SKIP_TASKBAR 消息。 Wayland 没有直接等效项,并且已知解决方法具有不可接受的折衷方案(例如,GNOME 中的 Window.is_skip_taskbar 需要不安全模式),因此 Electron 无法在 Linux 上支持此功能。

结束对 17.x.y 的支持

根据该项目的 支持策略,Electron 17.x.y 已停止支持。 建议开发人员和应用程序升级到较新版本的 Electron。

E18 (2022年3月)E19 (22 年 5 月)E20 (22 年 8 月)E21 (22 年 9 月)E22 (2022年12月)
18.x.y19.x.y20.x.y21.x.y22.x.y
17.x.y18.x.y19.x.y20.x.y21.x.y
16.x.y17.x.y18.x.y19.x.y20.x.y
15.x.y--------

下一步是什么

在短期内,您可以期望该团队继续专注于跟上构成 Electron 的主要组件(包括 Chromium、Node 和 V8)的开发。 尽管我们谨慎不对发布日期做出承诺,但我们的计划是大约每 2 个月发布 Electron 的新主要版本,其中包含这些组件的新版本。

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

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

Electron 19.0.0

·3 分钟阅读

Electron 19.0.0 已发布!它包括 Chromium 102、V8 10.2 和 Node.js 16.14.2 的升级。请阅读下文了解更多详情!


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

值得注意的变化

Electron 发布节奏变更

该项目正在恢复其早期支持最新三个主要版本的策略。 请参阅我们的版本控制文档,以获取有关 Electron 版本控制和支持的更详细信息。 这暂时是四个主要版本,以帮助用户适应从 Electron 15 开始的新发布节奏。 您可以阅读此处的完整详细信息

堆栈变化

重大变更和 API 变更

以下是 Electron 19 中引入的重大变更。有关这些及未来变更的更多信息,请参见 计划的重大变更 页面。

在 Linux 上不受支持:.skipTaskbar

在 Linux 上不再支持 BrowserWindow 构造函数选项 skipTaskbar。在 #33226 中进行了更改

已移除 WebPreferences.preloadURL

已从 WebPreferences 中移除半文档化的 preloadURL 属性。 #33228. 应该使用 WebPreferences.preload

结束对 15.x.y 和 16.x.y 的支持

Electron 14.x.y 和 15.x.y 均已停止支持。 这 返回 Electron 到其 现有策略,即支持最新的三个主要版本。 建议开发人员和应用程序升级到较新版本的 Electron。

E15 (2021年9月)E16 (2021年11月)E17 (2022年2月)E18 (2022年3月)E19 (22 年 5 月)
15.x.y16.x.y17.x.y18.x.y19.x.y
14.x.y15.x.y16.x.y17.x.y18.x.y
13.x.y14.x.y15.x.y16.x.y17.x.y
12.x.y13.x.y14.x.y15.x.y--

下一步是什么

在短期内,您可以期望该团队继续专注于跟上构成 Electron 的主要组件(包括 Chromium、Node 和 V8)的开发。 尽管我们谨慎不对发布日期做出承诺,但我们的计划是大约每 2 个月发布 Electron 的新主要版本,其中包含这些组件的新版本。

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

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

Electron 18.0.0

·4 分钟阅读

Electron 18.0.0 已发布!它包括 Chromium 100、V8 10.0 和 Node.js 16.13.2 的升级。请阅读下文了解更多详情!


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

值得注意的变化

Electron 发布节奏变更

从 Electron 15 开始,Electron 将每 8 周发布一个新的主要稳定版本。 您可以阅读此处的完整详细信息

此外,Electron 已将支持的版本从最新的三个版本更改为最新的四个版本,直到 2022 年 5 月。 请参阅我们的版本控制文档,以获取有关 Electron 中版本控制的更详细信息。 2022 年 5 月之后,我们将恢复支持最新的三个版本。

堆栈变化

突出显示的功能

  • 添加了 ses.setCodeCachePath() API,用于设置代码缓存目录。 #33286
  • 删除了基于旧的 BrowserWindowProxywindow.open 实现。 这也从 webPreferences 中删除了 nativeWindowOpen 选项。 #29405
  • WebContents 添加了“focus”和“blur”事件。 #25873
  • 在 macOS 上添加了替换菜单角色:showSubstitutionstoggleSmartQuotestoggleSmartDashestoggleTextReplacement#32024
  • app.requestSingleInstanceLock() 流程添加了 first-instance-ack 事件,允许用户无缝地将数据从第一个实例传输到第二个实例。 #31460
  • 添加了对 setBackgroundColor 中更多颜色格式的支持。 #33364

有关新功能和更改的完整列表,请参见 18.0.0 发行说明

重大变更和 API 变更

以下是 Electron 18 中引入的重大变更。有关这些及未来变更的更多信息,请参见 计划的重大变更 页面。

已移除:nativeWindowOpen

在 Electron 15 之前,默认情况下对 window.open 进行填充以使用 BrowserWindowProxy。 这意味着 window.open('about:blank') 无法打开同步可编写脚本的子窗口,以及其他不兼容之处。 自 Electron 15 以来,默认情况下已启用 nativeWindowOpen

有关更多详细信息,请参见 Electron 中 window.open 的文档。 在 #29405 中移除

结束对 14.x.y 的支持

根据该项目的 支持策略,Electron 14.x.y 已停止支持。 建议开发人员和应用程序升级到较新版本的 Electron。

从 Electron 15 开始,我们已将支持的版本从最新的三个版本更改为最新的四个版本,直到 2022 年 5 月的 Electron 19。 在 Electron 19 之后,我们将恢复支持最新的三个版本。 此版本支持变更是我们新的节奏变更的一部分。 请参见我们的博客文章,了解此处的完整详细信息

E15 (2021年9月)E16 (2021年11月)E17 (2022年2月)E18 (2022年3月)E19 (22 年 5 月)
15.x.y16.x.y17.x.y18.x.y19.x.y
14.x.y15.x.y16.x.y17.x.y18.x.y
13.x.y14.x.y15.x.y16.x.y17.x.y
12.x.y13.x.y14.x.y15.x.y--

下一步是什么

在短期内,您可以期望该团队继续专注于跟上构成 Electron 的主要组件(包括 Chromium、Node 和 V8)的开发。 尽管我们谨慎不对发布日期做出承诺,但我们的计划是大约每 2 个月发布 Electron 的新主要版本,其中包含这些组件的新版本。

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

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