Main.openBrowser(): try to use XDG Desktop Portal OpenURI on Linux if the AWT-based method is not available / fails

Author: bwRavencl

src/main/java/de/bwravencl/controllerbuddy/dbus/freedesktop/OpenURI.java

@@ -0,0 +1,30 @@
+/* Copyright (C) 2025  Matteo Hausner
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package de.bwravencl.controllerbuddy.dbus.freedesktop;
+
+import java.util.Map;
+import org.freedesktop.dbus.DBusPath;
+import org.freedesktop.dbus.annotations.DBusInterfaceName;
+import org.freedesktop.dbus.interfaces.DBusInterface;
+import org.freedesktop.dbus.types.Variant;
+
+@DBusInterfaceName("org.freedesktop.portal.OpenURI")
+public interface OpenURI extends DBusInterface {
+
+	@SuppressWarnings("MethodNameSameAsClassName")
+	DBusPath OpenURI(String parentWindow, String uri, Map<String, Variant<?>> options);
+}

src/main/java/de/bwravencl/controllerbuddy/dbus/freedesktop/Request.java

@@ -0,0 +1,46 @@
+/* Copyright (C) 2025  Matteo Hausner
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package de.bwravencl.controllerbuddy.dbus.freedesktop;
+
+import java.util.Map;
+import org.freedesktop.dbus.annotations.DBusInterfaceName;
+import org.freedesktop.dbus.exceptions.DBusException;
+import org.freedesktop.dbus.interfaces.DBusInterface;
+import org.freedesktop.dbus.messages.DBusSignal;
+import org.freedesktop.dbus.types.UInt32;
+import org.freedesktop.dbus.types.Variant;
+
+@SuppressWarnings("unused")
+@DBusInterfaceName("org.freedesktop.portal.Request")
+public interface Request extends DBusInterface {
+
+	class Response extends DBusSignal {
+
+		private final UInt32 response;
+
+		public Response(final String path, final UInt32 response, final Map<String, Variant<?>> results)
+				throws DBusException {
+			super(path, response, results);
+
+			this.response = response;
+		}
+
+		public UInt32 getResponse() {
+			return response;
+		}
+	}
+}

src/main/java/de/bwravencl/controllerbuddy/gui/Main.java

@@ -25,6 +25,8 @@
 import com.sun.jna.Platform;
 import com.sun.jna.platform.unix.X11;
 import de.bwravencl.controllerbuddy.constants.Constants;
+import de.bwravencl.controllerbuddy.dbus.freedesktop.OpenURI;
+import de.bwravencl.controllerbuddy.dbus.freedesktop.Request;
 import de.bwravencl.controllerbuddy.dbus.gnome.Extensions;
 import de.bwravencl.controllerbuddy.gui.GuiUtils.FrameDragListener;
 import de.bwravencl.controllerbuddy.input.Input;
@@ -135,6 +137,7 @@
 import java.util.Timer;
 import java.util.TimerTask;
 import java.util.concurrent.Callable;
+import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.Executors;
 import java.util.concurrent.ScheduledExecutorService;
 import java.util.concurrent.TimeUnit;
@@ -218,6 +221,7 @@
 import org.apache.commons.cli.HelpFormatter;
 import org.apache.commons.cli.Options;
 import org.apache.commons.cli.ParseException;
+import org.freedesktop.dbus.DBusMatchRule;
 import org.freedesktop.dbus.connections.impl.DBusConnectionBuilder;
 import org.lwjgl.glfw.GLFW;
 import org.lwjgl.system.Configuration;
@@ -1467,16 +1471,46 @@ public static void main(final String[] args) {
 	}
 
 	private static void openBrowser(final Component parentComponent, final URI uri) {
-		if (Desktop.isDesktopSupported() && Desktop.getDesktop().isSupported(Desktop.Action.BROWSE)) {
-			try {
-				Desktop.getDesktop().browse(uri);
-			} catch (final IOException e) {
-				throw new RuntimeException(e);
+		if (Desktop.isDesktopSupported()) {
+			final var desktop = Desktop.getDesktop();
+
+			if (desktop.isSupported(Desktop.Action.BROWSE)) {
+				try {
+					desktop.browse(uri);
+					return;
+				} catch (final Throwable t) {
+					log.log(Level.WARNING, t.getMessage(), t);
+				}
 			}
+		}
+
+		if (isLinux) {
+			new Thread(() -> {
+				var success = false;
+
+				try (final var dBusConnection = DBusConnectionBuilder.forSessionBus().build()) {
+					final var openUriInterface = dBusConnection.getRemoteObject("org.freedesktop.portal.Desktop",
+							"/org/freedesktop/portal/desktop", OpenURI.class);
+
+					final var responseCompletableFuture = new CompletableFuture<Request.Response>();
+
+					try (final var _ = dBusConnection.addSigHandler(new DBusMatchRule(Request.Response.class),
+							responseCompletableFuture::complete)) {
+						final var requestPath = openUriInterface.OpenURI("", uri.toString(), Collections.emptyMap())
+								.getPath();
+						final var response = responseCompletableFuture.get(3, TimeUnit.SECONDS);
+						success = response.getPath().equals(requestPath) && response.getResponse().intValue() == 0;
+					}
+				} catch (final Throwable t) {
+					log.log(Level.WARNING, t.getMessage(), t);
+				}
+
+				if (!success) {
+					EventQueue.invokeLater(() -> showPleaseVisitDialog(parentComponent, uri));
+				}
+			}).start();
 		} else {
-			JOptionPane.showMessageDialog(parentComponent,
-					MessageFormat.format(strings.getString("PLEASE_VISIT_DIALOG_TEXT"), uri),
-					strings.getString("INFORMATION_DIALOG_TITLE"), JOptionPane.INFORMATION_MESSAGE);
+			showPleaseVisitDialog(parentComponent, uri);
 		}
 	}
 
@@ -1496,6 +1530,12 @@ private static void printCommandLineMessage(final String message) {
 		}
 	}
 
+	private static void showPleaseVisitDialog(final Component parentComponent, final URI uri) {
+		JOptionPane.showMessageDialog(parentComponent,
+				MessageFormat.format(strings.getString("PLEASE_VISIT_DIALOG_TEXT"), uri),
+				strings.getString("INFORMATION_DIALOG_TITLE"), JOptionPane.INFORMATION_MESSAGE);
+	}
+
 	private static void terminate(final int status, final Main main) {
 		if (main != null && main.taskRunner != null) {
 			main.taskRunner.shutdown();