This page describes how to build Zong!, i.e. compile the source code into an executable program.

There are two ways Gradle is a free project automation tool. Zong! includes a Gradle build script, which allows to build, run and test Zong!:

Build Zong! using the Gradle build script

Gradle is a free project automation tool. See the documentation for installation instructions.the projects on the command line, without any IDE like Eclipse or IntelliJ IDEA. Since Zong! contains the Gradle wrapper, Gradle does not have to be installed but bootstraps from the included tools.

Our Jenkins build server also uses the Gradle script for automated building and continuous integration.

Here is a short screencast which demonstrates how to download and build Zong! using Git and Gradle:

Build

To build Zong! and create the packages for distribution, run In in the project's root foldergradle dist

gradlew


If you are running Linux or Mac OS X, use ./gradlew instead, since gradlew is a script in the root folder.

Please note that Zong! requires Java 8 Update 40 or later. If you are running Linux, you may want to read our short guide how to run different versions of Java in parallel.

Run

• Zong!

...

• Player:
  • gradlew -p player run
    
    
• Zong! Demos for developers:
  • gradlew -p demos run
    
    
  • or direct start of the demos:
    • gradlew runMinimalDemo
    • gradlew runSimpleGuiDemo
      
      
• More projects (viewer, editor, ...) will follow in the future.

Test

To run the automated JUnit tests in all modules, run

gradle test

Build Zong! using the Eclipse project

After Zong! was downloaded, it can be opened in the Eclipse IDE:

...

gradlew test

Android modules

The default build script does not build the Android modules. Enter the mobile-android folder and run gradlew (or ./gradlew in Linux and Mac OS X) there to build the Android project.

For running the app, we recommend using Android Studio.