From d2c65c8e7ded7bd43d50bfb59b1b6b592a90c34e Mon Sep 17 00:00:00 2001 From: Keeley Hammond Date: Thu, 5 Oct 2023 16:46:07 -0700 Subject: [PATCH 1/5] docs: add Electron 27 blog post --- blog/electron-27-0.md | 152 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 152 insertions(+) create mode 100644 blog/electron-27-0.md diff --git a/blog/electron-27-0.md b/blog/electron-27-0.md new file mode 100644 index 000000000..c8a52b2a1 --- /dev/null +++ b/blog/electron-27-0.md @@ -0,0 +1,152 @@ +--- +title: Electron 27.0.0 +date: 2023-10-10T00:00:00.000Z +authors: + - name: vertedinde + url: 'https://github.com/vertedinde' + image_url: 'https://github.com/vertedinde.png?size=96' +slug: electron-27-0 +--- + +Electron 27.0.0 has been released! It includes upgrades to Chromium `118.0.5993.32`, V8 `11.8`, and Node.js `18.17.1`. Read below for more details! + +--- + +The Electron team is excited to announce the release of Electron 27.0.0! You can install it with npm via `npm install electron@latest` or download it from our [releases website](https://releases.electronjs.org/releases/stable). Continue reading for details about this release. + +If you have any feedback, please share it with us on Twitter, or join our community [Discord](https://discord.com/invite/electronjs)! Bugs and feature requests can be reported in Electron's [issue tracker](https://github.com/electron/electron/issues). + +## Notable Changes + +### Stack Changes + +- Chromium `118.0.5993.32` + - [New in Chrome 118](https://developer.chrome.com/blog/new-in-chrome-118/) + - [New in DevTools 118](https://developer.chrome.com/blog/new-in-devtools-118/) +- Node.js `18.17.1` + - [Node 18.17.1 blog post](https://nodejs.org/en/blog/release/v18.17.1/) +- V8 `11.8` + +### Breaking Changes + +### Removed: Extended support for Windows 7/8/8.1 + +Electron 22 is now end of life (see [Farewell, Windows 7/8/8.1](https://www.electronjs.org/blog/windows-7-to-8-1-deprecation-notice) for more details). All currently supported versions of Electron have dropped support for Windows 7/8/8.1. + +### Removed: macOS 10.13 / 10.14 support + +macOS 10.13 (High Sierra) and macOS 10.14 (Mojave) are no longer supported by [Chromium](https://chromium-review.googlesource.com/c/chromium/src/+/4629466). + +Older versions of Electron will continue to run on these operating systems, but macOS 10.15 (Catalina) +or later will be required to run Electron v27.0.0 and higher. + +### Deprecated: `ipcRenderer.sendTo()` + +The `ipcRenderer.sendTo()` API has been deprecated. It should be replaced by setting up a [`MessageChannel`](tutorial/message-ports.md#setting-up-a-messagechannel-between-two-renderers) between the renderers. + +The `senderId` and `senderIsMainFrame` properties of `IpcRendererEvent` have been deprecated as well. + +### Removed: color scheme events in `systemPreferences` + +The following `systemPreferences` events have been removed: + +- `inverted-color-scheme-changed` +- `high-contrast-color-scheme-changed` + +Use the new `updated` event on the `nativeTheme` module instead. + +```js +// Removed +systemPreferences.on('inverted-color-scheme-changed', () => { + /* ... */ +}); +systemPreferences.on('high-contrast-color-scheme-changed', () => { + /* ... */ +}); + +// Replace with +nativeTheme.on('updated', () => { + /* ... */ +}); +``` + +### Removed: `webContents.getPrinters` + +The `webContents.getPrinters` method has been removed. Use +`webContents.getPrintersAsync` instead. + +```js +const w = new BrowserWindow({ show: false }); + +// Removed +console.log(w.webContents.getPrinters()); +// Replace with +w.webContents.getPrintersAsync().then((printers) => { + console.log(printers); +}); +``` + +### Removed: `systemPreferences.{get,set}AppLevelAppearance` and `systemPreferences.appLevelAppearance` + +The `systemPreferences.getAppLevelAppearance` and `systemPreferences.setAppLevelAppearance` +methods have been removed, as well as the `systemPreferences.appLevelAppearance` property. +Use the `nativeTheme` module instead. + +```js +// Removed +systemPreferences.getAppLevelAppearance(); +// Replace with +nativeTheme.shouldUseDarkColors; + +// Removed +systemPreferences.appLevelAppearance; +// Replace with +nativeTheme.shouldUseDarkColors; + +// Removed +systemPreferences.setAppLevelAppearance('dark'); +// Replace with +nativeTheme.themeSource = 'dark'; +``` + +### Removed: `alternate-selected-control-text` value for `systemPreferences.getColor` + +The `alternate-selected-control-text` value for `systemPreferences.getColor` +has been removed. Use `selected-content-background` instead. + +```js +// Removed +systemPreferences.getColor('alternate-selected-control-text'); +// Replace with +systemPreferences.getColor('selected-content-background'); +``` + +### New Features + +- Added app accessibility transparency settings api [#39631](https://github.com/electron/electron/pull/39631) +- Added support for `chrome.scripting` extension APIs [#39675](https://github.com/electron/electron/pull/39675) +- Enabled `WaylandWindowDecorations` by default [#39644](https://github.com/electron/electron/pull/39644) + +## End of Support for 24.x.y + +Electron 24.x.y has reached end-of-support as per the project's [support policy](https://www.electronjs.org/docs/latest/tutorial/electron-timelines#version-support-policy). Developers and applications are encouraged to upgrade to a newer version of Electron. + +| E27 (Aug'23) | E28 (Oct'23) | E29 (Jan'24) | +| ------------ | ------------ | ------------ | +| 27.x.y | 28.x.y | 29.x.y | +| 26.x.y | 27.x.y | 28.x.y | +| 25.x.y | 26.x.y | 27.x.y | + +## End of Extended Support for 22.x.y + +Earlier this year, the Electron team extended Electron 22's planned end of life date from May 30, 2023 to October 10, 2023, in order to match Chrome's extended support for Windows 7/8/8.1 (see [Farewell, Windows 7/8/8.1](https://www.electronjs.org/blog/windows-7-to-8-1-deprecation-notice) for more details). + +Electron 22.x.y has reached end-of-support as per the project's [support policy](https://www.electronjs.org/docs/latest/tutorial/electron-timelines#version-support-policy) and this support extension. This will drop support back to the latest three stable major versions, and will end official support for Windows 7/8/8.1. + +## What's Next + +In the short term, you can expect the team to continue to focus on keeping up with the development of the major components that make up Electron, including Chromium, Node, and V8. + +You can find [Electron's public timeline here](https://www.electronjs.org/docs/latest/tutorial/electron-timelines). + +More information about future changes can be found on the [Planned Breaking Changes](https://github.com/electron/electron/blob/main/docs/breaking-changes.md) page. From 03bd63ee5a36b70dd44e7774b111c73306a9746a Mon Sep 17 00:00:00 2001 From: Keeley Hammond Date: Fri, 6 Oct 2023 10:44:34 -0700 Subject: [PATCH 2/5] docs: fix new feature link Co-authored-by: David Sanders --- blog/electron-27-0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/blog/electron-27-0.md b/blog/electron-27-0.md index c8a52b2a1..8ed0e05c3 100644 --- a/blog/electron-27-0.md +++ b/blog/electron-27-0.md @@ -42,7 +42,7 @@ or later will be required to run Electron v27.0.0 and higher. ### Deprecated: `ipcRenderer.sendTo()` -The `ipcRenderer.sendTo()` API has been deprecated. It should be replaced by setting up a [`MessageChannel`](tutorial/message-ports.md#setting-up-a-messagechannel-between-two-renderers) between the renderers. +The `ipcRenderer.sendTo()` API has been deprecated. It should be replaced by setting up a [`MessageChannel`](https://www.electronjs.org/docs/latest/tutorial/message-ports#setting-up-a-messagechannel-between-two-renderers) between the renderers. The `senderId` and `senderIsMainFrame` properties of `IpcRendererEvent` have been deprecated as well. From e7a9036b719d843ca845ec973cad160ccdda4a55 Mon Sep 17 00:00:00 2001 From: Keeley Hammond Date: Mon, 9 Oct 2023 15:20:40 -0700 Subject: [PATCH 3/5] docs: fix months in EOL chart --- blog/electron-27-0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/blog/electron-27-0.md b/blog/electron-27-0.md index 8ed0e05c3..e3f833a8c 100644 --- a/blog/electron-27-0.md +++ b/blog/electron-27-0.md @@ -131,7 +131,7 @@ systemPreferences.getColor('selected-content-background'); Electron 24.x.y has reached end-of-support as per the project's [support policy](https://www.electronjs.org/docs/latest/tutorial/electron-timelines#version-support-policy). Developers and applications are encouraged to upgrade to a newer version of Electron. -| E27 (Aug'23) | E28 (Oct'23) | E29 (Jan'24) | +| E27 (Oct'23) | E28 (Dec'23) | E29 (Feb'24) | | ------------ | ------------ | ------------ | | 27.x.y | 28.x.y | 29.x.y | | 26.x.y | 27.x.y | 28.x.y | From e262b5914d21b625d77fe60d3033b2f370d813b8 Mon Sep 17 00:00:00 2001 From: Keeley Hammond Date: Tue, 10 Oct 2023 10:47:58 -0700 Subject: [PATCH 4/5] docs: apply suggestions from code review Co-authored-by: Tierney Cyren --- blog/electron-27-0.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/blog/electron-27-0.md b/blog/electron-27-0.md index e3f833a8c..4a8f82f9f 100644 --- a/blog/electron-27-0.md +++ b/blog/electron-27-0.md @@ -8,13 +8,13 @@ authors: slug: electron-27-0 --- -Electron 27.0.0 has been released! It includes upgrades to Chromium `118.0.5993.32`, V8 `11.8`, and Node.js `18.17.1`. Read below for more details! +Electron 27.0.0 has been released! It includes upgrades to Chromium `118.0.5993.32`, V8 `11.8`, and Node.js `18.17.1`. --- The Electron team is excited to announce the release of Electron 27.0.0! You can install it with npm via `npm install electron@latest` or download it from our [releases website](https://releases.electronjs.org/releases/stable). Continue reading for details about this release. -If you have any feedback, please share it with us on Twitter, or join our community [Discord](https://discord.com/invite/electronjs)! Bugs and feature requests can be reported in Electron's [issue tracker](https://github.com/electron/electron/issues). +If you have any feedback, please share it with us on [Twitter](https://twitter.com/electronjs), or join our community [Discord](https://discord.com/invite/electronjs)! Bugs and feature requests can be reported in Electron's [issue tracker](https://github.com/electron/electron/issues). ## Notable Changes From 946bc255baacaf763e4c8e669dab5f0ae31e2472 Mon Sep 17 00:00:00 2001 From: Keeley Hammond Date: Tue, 10 Oct 2023 10:52:59 -0700 Subject: [PATCH 5/5] docs: remove Windows 7 section, add Node 18.17.0 and Mastodon link --- blog/electron-27-0.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/blog/electron-27-0.md b/blog/electron-27-0.md index 4a8f82f9f..24fcc5bab 100644 --- a/blog/electron-27-0.md +++ b/blog/electron-27-0.md @@ -14,7 +14,7 @@ Electron 27.0.0 has been released! It includes upgrades to Chromium `118.0.5993. The Electron team is excited to announce the release of Electron 27.0.0! You can install it with npm via `npm install electron@latest` or download it from our [releases website](https://releases.electronjs.org/releases/stable). Continue reading for details about this release. -If you have any feedback, please share it with us on [Twitter](https://twitter.com/electronjs), or join our community [Discord](https://discord.com/invite/electronjs)! Bugs and feature requests can be reported in Electron's [issue tracker](https://github.com/electron/electron/issues). +If you have any feedback, please share it with us on [Twitter](https://twitter.com/electronjs) or [Mastodon](https://social.lfx.dev/@electronjs), or join our community [Discord](https://discord.com/invite/electronjs)! Bugs and feature requests can be reported in Electron's [issue tracker](https://github.com/electron/electron/issues). ## Notable Changes @@ -25,14 +25,11 @@ If you have any feedback, please share it with us on [Twitter](https://twitter.c - [New in DevTools 118](https://developer.chrome.com/blog/new-in-devtools-118/) - Node.js `18.17.1` - [Node 18.17.1 blog post](https://nodejs.org/en/blog/release/v18.17.1/) + - [Node 18.17.0 blog post](https://nodejs.org/en/blog/release/v18.17.0/) - V8 `11.8` ### Breaking Changes -### Removed: Extended support for Windows 7/8/8.1 - -Electron 22 is now end of life (see [Farewell, Windows 7/8/8.1](https://www.electronjs.org/blog/windows-7-to-8-1-deprecation-notice) for more details). All currently supported versions of Electron have dropped support for Windows 7/8/8.1. - ### Removed: macOS 10.13 / 10.14 support macOS 10.13 (High Sierra) and macOS 10.14 (Mojave) are no longer supported by [Chromium](https://chromium-review.googlesource.com/c/chromium/src/+/4629466).