Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 2, 2026

Fix AppImage Generation Error - Implementation Plan

  • Understand the problem: AppImage generation fails due to JavaFX modules not being found
  • Review the workflow file and AppImage generation script
  • Add Maven dependency resolution step in release-packages.yml workflow
  • Verify the change is minimal and correctly placed
  • Validate the workflow syntax with actionlint (passed)
  • Request code review
  • Run security checks
Original prompt

Problem

The AppImage generation is failing in the GitHub Actions workflow with the following error:

Error: Module javafx.base not found
java.lang.module.FindException: Module javafx.base not found

This occurs when running ./scripts/generate-appimage.sh during the Linux packages build.

Root Cause

The jlink command is trying to include JavaFX modules, but JavaFX is not part of the standard JDK and is distributed as external dependencies. The script correctly attempts to:

  1. Create a JRE with only standard Java modules
  2. Copy JavaFX JARs separately from Maven dependencies

However, the JavaFX dependencies may not be fully resolved/downloaded to the local Maven repository when the script tries to copy them.

Solution

Add a step in the release-packages.yml workflow to explicitly resolve and download all Maven dependencies (including JavaFX) before running the AppImage generation script.

Changes Required

In .github/workflows/release-packages.yml, add a new step after "Build with Maven" and before "Derive version from tag":

- name: Download all Maven dependencies (including JavaFX)
  run: mvn -B -ntp dependency:resolve dependency:resolve-plugins

This ensures that:

  • All JavaFX JARs are downloaded to ~/.m2/repository before the script runs
  • The script can successfully copy JavaFX dependencies when building the AppImage
  • The build is more reliable and doesn't depend on cached dependencies

Expected Outcome

After this change, the generate-appimage.sh script should:

  1. Successfully create the custom JRE with standard Java modules
  2. Find and copy all required JavaFX JARs from the Maven repository
  3. Complete the AppImage generation without errors

This pull request was created from Copilot chat.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI self-assigned this Jan 2, 2026
Co-authored-by: mrhunsaker <3277946+mrhunsaker@users.noreply.github.com>
@mrhunsaker mrhunsaker marked this pull request as ready for review January 2, 2026 20:52
@mrhunsaker mrhunsaker merged commit 7d9b6f5 into main Jan 2, 2026
1 of 2 checks passed
@mrhunsaker mrhunsaker deleted the copilot/fix-appimage-generation-error branch January 2, 2026 20:52
Copilot AI requested a review from mrhunsaker January 2, 2026 20:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants