Building Weasis

These instructions describe how to build Weasis directly from the Git repository on any platform. For building Weasis from an IDE, see Weasis plug-in development guidelines .

Prerequisites

  1. JDK 17 or higher
  2. Maven 3.5.3 or higher
    If your computer is behind a proxy server, configure maven .
  3. Git or directly download source from GitHub

Getting the Source

In order to clone the repository, first install GIT and either clone using a graphical GIT client or directly from the command line using the command:

git clone https://github.com/nroduit/Weasis.git

Building all Plug-ins

  • Go in the Weasis directory, compile and install all the plug-ins in the local Maven repository:

    mvn clean install

  • Package the distribution (output files are located in target/native-dist/) v4.0.0 :

    mvn -P compressXZ -f weasis-distributions clean package
    Tip

    -P compressXZ: Option for compressing the packages in xz , only from Weasis 3.6.0. The compression pack200 is not supported anymore (removed from Java 14), before 3.6.0 the profile was -P pack200.

    Tip

    -P purgeI18nPackage: Option to delete the translation package in the local maven repository (active by default). To disable this option, add - before the profile:

    mvn -P compressXZ,-purgeI18nPackage -f weasis-distributions clean package
    Warning

    For production, version must not be SNAPSHOT (otherwise packages will not be kept in cache). So to remove SNAPASHOT or to make your own release (for avoiding package mix-up in cache), modify the changelist property. From the Weasis root folder, execute:

    mvn -Dchangelist=-mybuild-beta clean install
    mvn -Dchangelist=-mybuild-beta -P compressXZ -f weasis-distributions clean package

Building native binaries and installers

Since v4.0.0 , the native installer has completely replaced the portable and the Java Webstart distributions.

The official build is done by Github actions with GitHub-hosted runners (Linux, Mac OS and Windows).

However, it is possible to run a local script weasis-distributions/script/package-weasis.sh on most systems but without guarantee because the system must have a correct configuration of several tools (see jpackage prerequisites ).

  • From the Weasis root folder, unzip the package built in the previous step:
    unzip weasis-distributions/target/native-dist/weasis-native.zip -d weasis-distributions/target/native-dist/weasis-native/
  • Build only the native binaries (without installer)
    weasis-distributions/script/package-weasis.sh --input ./weasis-distributions/target/native-dist/weasis-native --output build-dist --no-installer --jdk /home/.jdks/temurin-18.0.1
  • Build the native binaries and the installer
    weasis-distributions/script/package-weasis.sh --input ./weasis-distributions/target/native-dist/weasis-native --output build-installer --jdk /home/.jdks/temurin-18.0.1
Note

In the commands above, adapt the options --output and --jdk to your configuration.
In order to see the use of the script and its options, run:

weasis-distributions/script/package-weasis.sh --help
Tip

On Windows the bash script must be executed with Git Bash or Cygwin. Avoid having spaces in the input and output paths.