From b92c68b05311f635e3e3e210d03bf1cdfbb36b44 Mon Sep 17 00:00:00 2001 From: Calvin Date: Fri, 25 Apr 2025 14:31:28 -0600 Subject: [PATCH] docs: call out breaking change for GTK 4 default on GNOME (#46793) docs: add breaking change for GTK 4 default on GNOME --- docs/breaking-changes.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/breaking-changes.md b/docs/breaking-changes.md index 5112b29f0fd..d8e753eb99e 100644 --- a/docs/breaking-changes.md +++ b/docs/breaking-changes.md @@ -115,6 +115,24 @@ It has been always returning `true` since Electron 23, which only supports Windo https://learn.microsoft.com/en-us/windows/win32/dwm/composition-ovw#disabling-dwm-composition-windows7-and-earlier +### Changed: GTK 4 is default when running GNOME + +After an [upstream change](https://chromium-review.googlesource.com/c/chromium/src/+/6310469), GTK 4 is now the default when running GNOME. + +In rare cases, this may cause some applications or configurations to [error](https://github.com/electron/electron/issues/46538) with the following message: + +```stderr +Gtk-ERROR **: 11:30:38.382: GTK 2/3 symbols detected. Using GTK 2/3 and GTK 4 in the same process is not supported +``` + +Affected users can work around this by specifying the `gtk-version` command-line flag: + +```shell +$ electron --gtk-version=3 # or --gtk-version=2 +``` + +The same can be done with the [`app.commandLine.appendSwitch`](https://www.electronjs.org/docs/latest/api/command-line#commandlineappendswitchswitch-value) function. + ## Planned Breaking API Changes (35.0) ### Behavior Changed: Dialog API's `defaultPath` option on Linux