Skip to content

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

Open
Ali-Shariati-Najafabadi wants to merge 10 commits into
devonfw:mainfrom
Ali-Shariati-Najafabadi:feature/2206-fix-macos-gui-dock-title
Open

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

Conversation

@Ali-Shariati-Najafabadi

@Ali-Shariati-Najafabadi Ali-Shariati-Najafabadi commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

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

  1. 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).
  2. Check the Dock and the menu bar (⌘+Tab app switcher) while the GUI is running: the title now shows "IDEasy" instead of "java".
  3. 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"

@github-project-automation github-project-automation Bot moved this to 🆕 New in IDEasy board Aug 11, 2026
@Ali-Shariati-Najafabadi 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 Ali-Shariati-Najafabadi moved this from 🆕 New to 🏗 In progress in IDEasy board Aug 11, 2026
@coveralls

coveralls commented Aug 11, 2026

Copy link
Copy Markdown
Collaborator

Coverage Report for CI Build 33382581957

Coverage increased (+0.01%) to 73.639%

Details

  • Coverage increased (+0.01%) from the base build.
  • Patch coverage: No coverable lines changed in this PR.
  • No coverage regressions found.

Uncovered Changes

No uncovered changes found.

Coverage Regressions

No coverage regressions found.


Coverage Stats

Coverage Status
Relevant Lines: 18369
Covered Lines: 14139
Line Coverage: 76.97%
Relevant Branches: 8136
Covered Branches: 5379
Branch Coverage: 66.11%
Branches in Coverage %: Yes
Coverage Strength: 3.29 hits per line

💛 - Coveralls

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

@laim2003 laim2003 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Image

@Ali-Shariati-Najafabadi

Copy link
Copy Markdown
Contributor Author

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

Image

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
laim2003 self-requested a review August 24, 2026 09:49

@laim2003 laim2003 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 😄

Comment thread CHANGELOG.adoc Outdated
Comment thread cli/src/test/java/com/devonfw/tools/ide/tool/gui/GuiTest.java Outdated
Comment thread cli/src/main/java/com/devonfw/tools/ide/tool/gui/Gui.java Outdated
Comment thread cli/src/main/java/com/devonfw/tools/ide/tool/gui/Gui.java Outdated
Comment thread cli/src/main/java/com/devonfw/tools/ide/tool/gui/Gui.java Outdated
Comment thread cli/src/main/java/com/devonfw/tools/ide/tool/gui/Gui.java Outdated

@laim2003 laim2003 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good and still works👍

@laim2003 laim2003 moved this from Team Review to 👀 In review in IDEasy board Aug 31, 2026
@laim2003
laim2003 requested a review from hohwille August 31, 2026 12:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bugfix PR that fixes a bug issue GUI Graphical User Interface of IDEasy (aka dashboard) build with JavaFx macOS specific for Apple MacOS

Projects

Status: 👀 In review

Development

Successfully merging this pull request may close these issues.

IDEasy title not properly shown on macOS

5 participants