Building & Running

Platform-specific build and run scripts are included in the repository root. Each script compiles all source files and packages them into GSO-Data-Helper.jar.

Windows

build-windows.bat   -- compile + package into GSO-Data-Helper.jar
run-windows.bat     -- run GSO-Data-Helper.jar

Double-click the batch files in Explorer, or run them from Command Prompt. Java 21 must be on your system PATH.

Linux / macOS

Make the scripts executable, then run them:

chmod +x build-linux-mac.sh && ./build-linux-mac.sh
chmod +x run-linux-mac.sh   && ./run-linux-mac.sh

You only need to chmod +x once per clone.

Running the Jar Directly

Once built, you can launch the application directly from any terminal on any platform:

java -jar GSO-Data-Helper.jar

How the Build Works

The build script:

1. Lists all .java files under src/ into a sources list file (@sources.txt)
2. Compiles them all with javac — the @sources.txt approach avoids command-line length limits on Windows
3. Packages the compiled .class files into GSO-Data-Helper.jar with the correct Main-Class manifest entry pointing to com.gso.datahelper.GSODataHelper

Troubleshooting

Symptom	Likely cause	Fix
javac: command not found	JDK not installed or not on PATH	Install Java 21 JDK and add it to PATH
UnsupportedClassVersionError	Running with Java older than 21	Update your JRE/JDK to 21+
Blank window on macOS	macOS Retina display DPI issue	Add -Dapple.awt.application.name=GSODataHelper to the run command
Build script exits silently	No .java files found (wrong working directory)	Run the script from the project root, not from src/