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

JDK 17 or higher
Maven 3.5.3 or higher
If your computer is behind a proxy server, configure maven .
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.