Building from Source · Wiki · Campbell Jones / Wraith Master

Build Dependencies

Wraith Master requires the following packages to build:

Distribution	JDK	Both Frontends	GTK Only
Debian/Derivatives	`openjdk-8-jdk` or newer	`libusb-1.0-0-dev`, `gcc-multilib`, `libncurses5`	`libgtk-3-dev`
Arch/Derivatives	`jdk8-openjdk` or newer	`ncurses5-compat-libs` (AUR)	`gtk3`
Fedora	`java-1.8.0-openjdk` or newer	`libusbx-devel`, `ncurses-compat-libs`	`gtk3-devel`
OpenSUSE	`java-1_8_0-openjdk` or newer	`libusb-1_0-devel`, `libncurses5`	`gtk3-devel`
Solus	`openjdk-8` or newer	`libusb-devel`	`libgtk-3-devel`
Gentoo	`dev-java/openjdk`	`dev-libs/libusb`, `ncurses-compat`	`gtk+`

Instructions

Each Gradle command that follows can be run with the subproject name as a prefix in order to only build and install specific artifacts. For instance, :cli:package would build the command line artifact, and :gtk:package would build the GTK artifact.

Building

To build all artifacts and place them in the build/package directory, run the following:

./gradlew package

Installation

To install the built artifacts and their associated resources, run the following:

./gradlew install

Options

These options can be used to modify the packaging and installation of Wraith Master. The "Task" section details which task (package or install) the option affects, and the "Value" section details how the option should be passed. If an option has a "Value" of "None", it should be passed like -Pstrip; if it has a "Value" of "String", it should be passed like -Pinstalldir=/usr.

Option	Task	Value	Description
`-Pstrip`	`package`	None	Strips the binaries. This makes them smaller, but makes errors significantly harder to trace. Not recommended.
`-Pinstalldir`	`install`	String	Changes where all files except the udev rules will be placed on install. Defaults to `/usr/local/`. If set, overrides `installmode`.
`-Pudevdir`	`install`	String	Changes where the udev rules will be placed on install. Defaults to `/etc/udev/`.
`-Pnoudev`	`install`	None	Disables the automatic installation of udev rules when the host system supports udev.
`-Pforceudev`	`install`	None	Only in master. Forces the installation of udev rules even on a system without udev installed. Useful for packaging.
`-Pinstallmode`	`install`	Enum	Only in master. If `system`, changes the default `installdir` to `/usr/` and default `udevdir` to `/usr/lib/udev/`. If unset or `local`, uses defaults for both.
`-Ppackageroot`	`install`	String	Only in master. When set, changes the default value of `installmode` to `system` if `installmode` is unset, and changes the parent directory of `installdir` and `udevdir` to this path.