How to generate the JAR file:
In IntelliJ, open the Maven tool window (View -> Tool Windows -> Maven if not already up). Toggle the "Skip Tests" mode to true to avoid failing UI tests, then double click the package target under "Lifecycle".
Some output should be printed to the terminal. If successful, the target subfolder should be created under the project root. This folder should be gitignored so keeping it around is fine. In that folder, several JARs will be created - the one we are looking for is uml-diagram-collab-1.0-SNAPSHOT.jar. DO NOT double click it to run from IntelliJ!
How to run the JAR file:
Via explorer: find it in the file explorer (from IntelliJ, right-click -> Open In -> Explorer). Double-click it in the file explorer and it should open the start screen. This is how users are expected to open the app.
Via terminal: open a command terminal in the directory containing the JAR file. Then, run java -jar uml-diagram-collab-1.0-SNAPSHOT.jar. This should open the start screen. This is not how users are expected to run the app, but it does provide access to the console for debug output for developers.
Warnings:
DO NOT double click the JAR file to run from IntelliJ! This will start the application but not show anything.
While testing, I noticed that if an instance was already running via IntelliJ's double click, further attempts to open it from elsewhere will fail with an error about port binding. I had to go into the Task Manager to find and end the offending processes: the name of the process was "Java(TM) Platform SE Binary".
This PR fixes a major issue that affected the JAR version but not the version run via IntelliJ, in which the ElementCreator incorrectly accessed a file. The file access has been fixed to work on both. The error caused a failure when opening any diagram.
During my quick tests, I did not find any other outstanding issues with the JAR version, with 2 instances running on my machine. I briefly tested that the following work as they do in our IntelliJ runs:
Creating a new diagram
Joining a diagram
Updating the diagram (not exhaustively but all the new commands plus most of the old ones, except maybe remove)
How to generate the JAR file: In IntelliJ, open the Maven tool window (View -> Tool Windows -> Maven if not already up). Toggle the "Skip Tests" mode to true to avoid failing UI tests, then double click the
package
target under "Lifecycle". Some output should be printed to the terminal. If successful, thetarget
subfolder should be created under the project root. This folder should be gitignored so keeping it around is fine. In that folder, several JARs will be created - the one we are looking for isuml-diagram-collab-1.0-SNAPSHOT.jar
. DO NOT double click it to run from IntelliJ!How to run the JAR file:
java -jar uml-diagram-collab-1.0-SNAPSHOT.jar
. This should open the start screen. This is not how users are expected to run the app, but it does provide access to the console for debug output for developers.Warnings:
This PR fixes a major issue that affected the JAR version but not the version run via IntelliJ, in which the ElementCreator incorrectly accessed a file. The file access has been fixed to work on both. The error caused a failure when opening any diagram.
During my quick tests, I did not find any other outstanding issues with the JAR version, with 2 instances running on my machine. I briefly tested that the following work as they do in our IntelliJ runs: