Building Weasis

These instructions guide you through building Weasis directly from its GitHub repository. For IDE-based builds, refer to the Weasis plugin development guidelines.

Prerequisites

JDK 25 or higher
Maven 3.8.1 or higher
If your computer is behind a proxy server, refer to the Maven proxy configuration guide.
Git

Getting the Source Code

In order to clone the repository, install Git and either use a graphical client or run the following command in a terminal:

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

Building All Plugins

Navigate to the root directory of the cloned Weasis repository, compile and install all plugins into the local Maven repository:
```
mvn clean install
```
Package weasis-native.zip (located in target/native-dist/) since 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, the version must not include SNAPSHOT (as packages with a SNAPSHOT are always downloaded, not cached). To remove SNAPASHOT or create your own release (use a specific name to prevent package conflicts in the cache), update 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

The native installer has fully replaced the portable and Java WebStart distributions since v4.0.0.

The official build process is executed via GitHub Actions using GitHub-hosted runners across Linux, macOS, and Windows.

However, you can also build the native binaries and installer locally using the package-weasis.sh script. This process is not guaranteed to work on all systems, as it requires proper configuration of multiple tools. Refer to the jpackage prerequisites for more details.

Obtain the weasis-native.zip file, extract the archive, and navigate to the root folder in a Bash prompt.
Run the following command to build the native binaries and installer:
./build/script/package-weasis.sh --jdk "/home/.jdks/openjdk-25"

Note

Replace --jdk with the path to your local JDK installation.
To generate only the native binaries (without creating an installer), include the --no-installer flag.
For additional command options, run:
```
./build/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.