#2206: Fix IDEasy title not properly shown on macOS by Ali-Shariati-Najafabadi · Pull Request #2315 · devonfw/IDEasy

Ali-Shariati-Najafabadi · 2026-08-11T16:17:14Z

This PR fixes #2206

Implemented changes:

On macOS, ide gui now launches the JavaFX process through a symlink named IDEasy that points to the real java executable, instead of exec-ing java directly. macOS derives the Dock/menu bar title from the launched executable's filename (this GUI has no native app bundle), so this makes the title read "IDEasy" instead of "java". No-op on Windows/Linux.
Note: an earlier approach of setting System.setProperty("apple.awt.application.name", "IDEasy") in App.java was tried and verified (by building and running the GUI locally) to have no effect, since this GUI is pure JavaFX (Glass toolkit) and that property is only read by AWT's toolkit.

Testing instructions

On macOS, run ide gui (or build the gui module and run com.devonfw.ide.gui.AppLauncher via the same exec:exec Maven invocation used by the gui commandlet).
Check the Dock and the menu bar (⌘+Tab app switcher) while the GUI is running: the title now shows "IDEasy" instead of "java".
Unit tests com.devonfw.tools.ide.tool.gui.GuiTest cover the executable resolution: a symlink named IDEasy is created and used on macOS, while Windows/Linux keep using the plain java executable unchanged.

Checklist for this PR

When running mvn clean test locally all tests pass and build is successful
PR title is of the form #«issue-id»: «brief summary».
PR top-level comment summarizes what has been done and contains link to addressed issue(s)
PR and issue(s) have suitable labels
Issue is set to In Progress and assigned to you or there is no issue (might happen for very small PRs)
You followed all coding conventions
You have added the issue implemented by your PR in CHANGELOG.adoc unless issue is labelled with internal
You have not changed any dependency in pom.xml files or otherwise if runtime dependencies changed, you have updated our LICENSE.asciidoc
You have formulated clear instructions on how to test your contribution under "Testing instructions"

coveralls · 2026-08-11T16:22:32Z

Coverage Report for CI Build 32151631791

Coverage increased (+0.04%) to 72.945%

Details

Coverage increased (+0.04%) from the base build.
Patch coverage: No coverable lines changed in this PR.
17 coverage regressions across 1 file.

Uncovered Changes

No uncovered changes found.

Coverage Regressions

17 previously-covered lines in 1 file lost coverage.

File	Lines Losing Coverage	Coverage
com/devonfw/tools/ide/tool/gui/Gui.java	17	39.29%

Coverage Stats


Relevant Lines:	17578
Covered Lines:	13372
Line Coverage:	76.07%
Relevant Branches:	7767
Covered Branches:	5116
Branch Coverage:	65.87%
Branches in Coverage %:	Yes
Coverage Strength:	3.23 hits per line

💛 - Coveralls

laim2003

Thanks for your PR! 🙂 For some reason though, the title in the Dock still shows up as "java":

…OS Dock title

Ali-Shariati-Najafabadi · 2026-08-17T13:24:27Z

Thanks for your PR! 🙂 For some reason though, the title in the Dock still shows up as "java":

I've pushed a fix. Tested locally and the Dock now correctly shows "IDEasy". Could you pull the latest commit and recheck on your end?

laim2003

Hi, thanks for the PR! Tested it on my mac and it works perfectly! Just added some thoughts that may improve this PR even more 😄

laim2003 · 2026-08-24T09:54:21Z

 * https://github.com/devonfw/IDEasy/issues/2292[#2292]: Questions appear twice
 * https://github.com/devonfw/IDEasy/issues/825[#825]: Add commandlet for GC Log Analyzer
 * https://github.com/devonfw/IDEasy/issues/1938[#1938]: GUI not launchable outside of project context
+* https://github.com/devonfw/IDEasy/issues/2206[#2206]: IDEasy title not properly shown on macOS


move this to 2026.08.02

laim2003 · 2026-08-24T10:17:26Z

+    // arrange
+    WindowsSymlinkTestHelper.assumeSymlinksSupported();
+    IdeTestContext context = newContext(PROJECT_BASIC, null, true);
+    ((AbstractIdeTestContext) context).setSystemInfo(SystemInfoMock.MAC_ARM64);


The cast ((AbstractIdeTestContext) context) is redundant, as IdeTestContext extends AbstractIdeTestContext

laim2003 · 2026-08-24T10:20:38Z

+  private static void writeFile(Path file, String content) {
+
+    try {
+      Files.writeString(file, content);
+    } catch (IOException e) {
+      throw new IllegalStateException("Failed to write file: " + file, e);
+    }
+  }


Suggested change

private static void writeFile(Path file, String content) {

try {

Files.writeString(file, content);

} catch (IOException e) {

throw new IllegalStateException("Failed to write file: " + file, e);

}

}

Redundant since we can use FileAccess's writeFileContent()

laim2003 · 2026-08-24T10:22:53Z

+    Path contentsDir = this.context.getTempPath().resolve("IDEasy.app").resolve("Contents");
+    Path launcher = contentsDir.resolve("MacOS").resolve("IDEasy");
+    this.context.getFileAccess().mkdirs(launcher.getParent());
+    writeFile(contentsDir.resolve("Info.plist"), GUI_INFO_PLIST);


Instead of creating our own helper method, we should be able to just use writeFileContent() from our exisitng FileAccess class.

laim2003 · 2026-08-24T10:34:38Z

+        <key>CFBundleExecutable</key>
+        <string>IDEasy</string>
+        <key>CFBundleIdentifier</key>
+        <string>%s</string>


Suggested change

<string>%s</string>

<string>com.devonfw.tools.ideasy.gui</string>

laim2003 · 2026-08-24T10:35:06Z

+
+  private static final String GUI_APP_BUNDLE_ID = "com.devonfw.tools.ideasy.gui";


Suggested change

private static final String GUI_APP_BUNDLE_ID = "com.devonfw.tools.ideasy.gui";

If we hardcode the APP_BUNDLE_ID anyways?, why dont we just include it in the GUI_INFO_PLIST string?

devonfw#2206: Fix IDEasy title not properly shown on macOS

0027f9c

github-project-automation Bot added this to IDEasy board Aug 11, 2026

github-project-automation Bot moved this to 🆕 New in IDEasy board Aug 11, 2026

Ali-Shariati-Najafabadi self-assigned this Aug 11, 2026

Ali-Shariati-Najafabadi added macOS specific for Apple MacOS GUI Graphical User Interface of IDEasy (aka dashboard) build with JavaFx bugfix PR that fixes a bug issue labels Aug 11, 2026

Ali-Shariati-Najafabadi moved this from 🆕 New to 🏗 In progress in IDEasy board Aug 11, 2026

Merge branch 'main' into feature/2206-fix-macos-gui-dock-title

607b72f

laert-ll assigned laim2003 Aug 12, 2026

Ali-Shariati-Najafabadi moved this from 🏗 In progress to Team Review in IDEasy board Aug 13, 2026

Ali-Shariati-Najafabadi and others added 2 commits August 13, 2026 12:42

Merge branch 'main' into feature/2206-fix-macos-gui-dock-title

fe7ecfa

Merge branch 'main' into feature/2206-fix-macos-gui-dock-title

c08fc32

laim2003 reviewed Aug 17, 2026

View reviewed changes

devonfw#2206: Wrap GUI launch in a minimal app bundle for correct mac…

29fccde

…OS Dock title

Merge branch 'main' into feature/2206-fix-macos-gui-dock-title

f4ab722

laim2003 self-requested a review August 24, 2026 09:49

laim2003 suggested changes Aug 24, 2026

View reviewed changes

devonfw#2206: Address review feedback on macOS Dock title fix

35a7ad3

Navigation Menu

Uh oh!

#2206: Fix IDEasy title not properly shown on macOS - #2315

#2206: Fix IDEasy title not properly shown on macOS#2315
Ali-Shariati-Najafabadi wants to merge 7 commits into
devonfw:mainfrom
Ali-Shariati-Najafabadi:feature/2206-fix-macos-gui-dock-title

Ali-Shariati-Najafabadi commented Aug 11, 2026 •

edited

Loading

Uh oh!

coveralls commented Aug 11, 2026 •

edited

Loading

Uh oh!

laim2003 left a comment

Uh oh!

Ali-Shariati-Najafabadi commented Aug 17, 2026

Uh oh!

laim2003 left a comment

Uh oh!

laim2003 Aug 24, 2026

Uh oh!

laim2003 Aug 24, 2026

Uh oh!

laim2003 Aug 24, 2026

Uh oh!

laim2003 Aug 24, 2026

Uh oh!

laim2003 Aug 24, 2026

Uh oh!

laim2003 Aug 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

	<string>%s</string>
	<string>com.devonfw.tools.ideasy.gui</string>


		private static final String GUI_APP_BUNDLE_ID = "com.devonfw.tools.ideasy.gui";

Uh oh!

Conversation

Ali-Shariati-Najafabadi commented Aug 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

This PR fixes #2206

Implemented changes:

Testing instructions

Checklist for this PR

Uh oh!

coveralls commented Aug 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Coverage Report for CI Build 32151631791

Coverage increased (+0.04%) to 72.945%

Details

Uncovered Changes

Coverage Regressions

Coverage Stats

💛 - Coveralls

Uh oh!

laim2003 left a comment

Choose a reason for hiding this comment

Uh oh!

Ali-Shariati-Najafabadi commented Aug 17, 2026

Uh oh!

laim2003 left a comment

Choose a reason for hiding this comment

Uh oh!

laim2003 Aug 24, 2026

Choose a reason for hiding this comment

Uh oh!

laim2003 Aug 24, 2026

Choose a reason for hiding this comment

Uh oh!

laim2003 Aug 24, 2026

Choose a reason for hiding this comment

Uh oh!

laim2003 Aug 24, 2026

Choose a reason for hiding this comment

Uh oh!

laim2003 Aug 24, 2026

Choose a reason for hiding this comment

Uh oh!

laim2003 Aug 24, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Ali-Shariati-Najafabadi commented Aug 11, 2026 •

edited

Loading

coveralls commented Aug 11, 2026 •

edited

Loading