Skip to content

#1917: add scripts for gui shortcut launcher windows, linux, macos#2037

Draft
quando632 wants to merge 7 commits into
devonfw:mainfrom
quando632:feature/1917-create-desktop-shortcut
Draft

#1917: add scripts for gui shortcut launcher windows, linux, macos#2037
quando632 wants to merge 7 commits into
devonfw:mainfrom
quando632:feature/1917-create-desktop-shortcut

Conversation

@quando632

@quando632 quando632 commented Jun 17, 2026

Copy link
Copy Markdown

This PR fixes #1917

Implemented changes:

  1. Adding scripts to launch the IDEasy GUI as desktop shortcut in Windows/MacOs/linux

Testing instructions

Please add conscise, understandable instructions on how a reviewer can test/verify the functionality of your contribution here:

  1. Test it on Windows by open the searchbar and search for "IDEasy Gui"
  2. Run the application shortcut "IDEasy Gui"
  3. If the GUI appears then it is working correct
  4. Same Workflow for Linux and MacOs

Checklist for this PR

Make sure everything is checked before merging this PR. For further info please also see
our DoD.

  • When running mvn clean test locally all tests pass and build is successful
  • PR title is of the form #«issue-id»: «brief summary» (e.g. #921: fixed setup.bat). If no issue ID exists, title only.
  • 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 labeled
    with internal
  • 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 Jun 17, 2026
@quando632 quando632 added enhancement New feature or request windows specific for Microsoft Windows OS macOS specific for Apple MacOS linux specific for linux OS (debian, ubunutu, suse, etc.) GUI Graphical User Interface of IDEasy (aka dashboard) build with JavaFx labels Jun 17, 2026
@CLAassistant

CLAassistant commented Jun 17, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@coveralls

coveralls commented Jun 17, 2026

Copy link
Copy Markdown
Collaborator

Coverage Report for CI Build 27815043827

Warning

Build has drifted: This PR's base is out of sync with its target branch, so coverage data may include unrelated changes.
Quick fix: rebase this PR. Learn more →

Coverage increased (+0.06%) to 71.356%

Details

  • Coverage increased (+0.06%) from the base build.
  • Patch coverage: No coverable lines changed in this PR.
  • 128 coverage regressions across 4 files.

Uncovered Changes

No uncovered changes found.

Coverage Regressions

128 previously-covered lines in 4 files lost coverage.

File Lines Losing Coverage Coverage
com/devonfw/tools/ide/context/AbstractIdeContext.java 113 67.48%
com/devonfw/tools/ide/tool/ide/IdeaBasedIdeToolCommandlet.java 8 81.34%
com/devonfw/tools/ide/log/IdeLogLevel.java 5 80.19%
com/devonfw/tools/ide/commandlet/EnvironmentCommandlet.java 2 86.96%

Coverage Stats

Coverage Status
Relevant Lines: 16274
Covered Lines: 12111
Line Coverage: 74.42%
Relevant Branches: 7284
Covered Branches: 4699
Branch Coverage: 64.51%
Branches in Coverage %: Yes
Coverage Strength: 3.15 hits per line

💛 - Coveralls

@laert-ll

Copy link
Copy Markdown
Contributor
 laert@arch  ~/projects/IDEasy_1917/workspaces/main/IDEasy/gui/scripts/linux   feature/1917-create-desktop-shortcut ±  ./create-shortcuts.sh          
✓ Created: /home/laert/.local/share/applications/ideasy-gui.desktop
ℹ Launch from: Application Menu or Launcher
✓ Created: /home/laert//ideasy-gui.desktop
ℹ Launch from: Desktop

✓ IDEasy GUI shortcuts ready!

Usage:
  • Open your Application Menu and search for 'IDEasy GUI'
  • Or double-click the shortcut on your Desktop
  • First launch may take longer as Maven downloads dependencies

 laert@arch  ~/projects/IDEasy_1917/workspaces/main/IDEasy/gui/scripts/linux   feature/1917-create-desktop-shortcut ±  /./home/laert/ideasy-gui.desktop
/./home/laert/ideasy-gui.desktop: line 1: [Desktop: command not found
/./home/laert/ideasy-gui.desktop: line 4: GUI: command not found
/./home/laert/ideasy-gui.desktop: line 5: IDEasy: command not found
/./home/laert/ideasy-gui.desktop: line 9: IDE: command not found

The script works and the shortcut does appear in the Application Menu, but I cannot seem to open it either from the Launcher or by using the script in the home directory itself.

@laert-ll

Copy link
Copy Markdown
Contributor
Screenshot From 2026-06-18 13-34-26
 laert@arch  ~/projects/IDEasy_1917/workspaces/main/IDEasy/gui/scripts/linux   feature/1917-create-desktop-shortcut ±  cat ~/.ideasy-gui.log        
---- Enj 18 Qer 2026 01:33:59.MD CEST ----
Error: IDEasy is not installed or not in PATH
Please install IDEasy first: https://github.com/devonfw/IDEasy#setup

As for the ideasy-gui.desktop script, I still get the same error message.

@quando632 quando632 moved this from 🆕 New to 🏗 In progress in IDEasy board Jun 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request GUI Graphical User Interface of IDEasy (aka dashboard) build with JavaFx linux specific for linux OS (debian, ubunutu, suse, etc.) macOS specific for Apple MacOS windows specific for Microsoft Windows OS

Projects

Status: 🏗 In progress

Development

Successfully merging this pull request may close these issues.

Allow the creation of a desktop shortcut for the GUI

4 participants