Develop a Laucher

The best to start a new launcher is to copy one of these 2 templates included in the SDK.
Name Comment Source, configuration & build script
success Launcher returning always success src/com/xqual/xlauncher/success/CLauncherImpl.java
src/com/xqual/xlauncher/success/success.xml
src/build/buildSuccessLauncher.bat
random Launcher returning random results src/com/xqual/xlauncher/random/CLauncherImpl.java
src/com/xqual/xlauncher/random/random.xml
src/build/buildRandomLauncher.bat
Let's assume we want to create an "imaginary" launcher. The preparation process is pretty simple and consist in doing the following:

  • Copy the folder src/com/xqual/launcher/random in src/com/xqual/launcher/imaginary
  • Rename src/com/xqual/launcher/random.xml in src/com/xqual/launcher/imaginary.xml
  • Modify the package and the static variable TRACE_HEADER in the CLauncherImpl.java source file
  • Copy and rename build/buildRandomLauncher.bat in build/buildImaginaryLauncher.bat
  • Edit the build script buildImaginaryLauncher.bat and change
    - the variable JAVA_HOME to point to your JDK.
    - the name of the launcher in the script XSTUDIO_LAUNCHER_NAME=imaginary
  • Run buildImaginaryLauncher.bat
  • You should get a file imaginary.jar in the bin folder

Congrats! you compiled your first launcher.