We have a few reports about the issue with launching GP 3.0 where it starts and hangs at the splash image (other symptoms are also possible)
Possible reasons and configurations where they are applicable to are listed below.
1. Missing update
This applies to GanttProject 3.0.+ on all operating systems. This is not applicable to GanttProject 3.1.+
GanttProject 3.0.+ may fail to launch because of a missing update which was skipped. Unfortunately, due to a bug in the update system, the update which was skipped won’t be install afterwards, even if subsequent updates depend on it.
Updates location on disk
The workaround which fixes such issues is to remove all installed updates from disk. Normally the updates sit in the folder
~/.ganttproject.d/updates in the user’s home folder.
Removing the updates
On macOS and Linux, one can remove the updates by running the following command in Terminal:
rm -rf ~/.ganttproject.d/updates
On Windows one can find and remove
.ganttproject.d. folder in the user’s home folder using their favorite file manager. The user home folder on the modern Windows systems is normally
C:\Users\<your user name here>.
Please pay attention to the leading dot in the folder name. Some file managers may hide such folders.
After removing the updates, launch GP 3.0 and let it install all updates. This should fix the issue.
2. Missing JavaFX libraries
This applies to GanttProject 3.1.3100 running on Linux systems and installed from DEB package.
GanttProject may fail to launch after installing update 3102 if there are no JavaFX libraries in the Java Runtime which is used for running GanttProject. Those libraries are shipped with DEB package, however, update 3102 replaces the plugin with these libraries with a newer version where JavaFX libraries are missing.
Windows and macOS distributions are not affected because they are bundled with Java Runtime which includes JavaFX. ZIP distribution is not affected because it never included JavaFX libs, so if it was working before installing update 3102, it should continue working after installing it.
Any of the following will solve the issue:
Use Java Runtime with JavaFX libraries, e.g. BellSoft Liberica Full JRE or Azul Zulu.
Copy JavaFX libraries from the base installation to the updates. The following command shall do the trick, provided that all installation paths are the default ones:
cp /usr/share/ganttproject/plugins/base/biz.ganttproject.app.libs/lib/javafx.* ~/.ganttproject.d/updates/update-3102/biz.ganttproject.app.libs/lib/