115 lines
3.3 KiB
Markdown
115 lines
3.3 KiB
Markdown
# Warp4j
|
|
|
|
Turn JAR (java archive) into self-contained executable in a single command.
|
|
|
|
## Features
|
|
|
|
- downloads java runtimes automatically
|
|
- makes runtimes optimized for your application
|
|
- creates self-contained binaries for Linux, macOS and Windows using [warp-packer](https://github.com/dgiagio/warp)
|
|
- works on Linux, macOS and Windows (with Windows Subsystem for Linux)
|
|
- supports cross "compilation"
|
|
- does not require neither JDK nor JRE installed
|
|
|
|
## TL;DR
|
|
|
|
Just put both `warp4j` and `warp-packer` somewhere in your PATH and run `warp4j app.jar`.
|
|
|
|
## Install
|
|
|
|
Curl one-liner installs latest versions of both `warp4j` and `warp-packer`:
|
|
|
|
```
|
|
$ bash -c "$(curl -fsSL https://raw.githubusercontent.com/guziks/warp4j/stable/install)"
|
|
```
|
|
|
|
This script will show missing dependencies (if there are any), they must be installed with your package manager.
|
|
|
|
See more install methods [here](INSTALL.md).
|
|
|
|
## Usage
|
|
|
|
```
|
|
$ ls
|
|
my-app.jar
|
|
|
|
$ warp4j my-app.jar
|
|
...
|
|
...
|
|
...
|
|
|
|
$ ls -1
|
|
my-app.jar
|
|
warped
|
|
|
|
$ ls warped
|
|
my-app-linux-x64
|
|
my-app-linux-x64.tar.gz
|
|
my-app-macos-x64
|
|
my-app-macos-x64.tar.gz
|
|
my-app-windows-x64.exe
|
|
my-app-windows-x64.zip
|
|
```
|
|
|
|
See help:
|
|
|
|
```
|
|
$ wapr4j --help
|
|
|
|
Usage: warp4j [options] <app.jar>
|
|
|
|
Turn JAR (java archive) into self-contained executable
|
|
|
|
Options:
|
|
-j, --java-version <version>
|
|
override JDK/JRE version
|
|
examples: "11", "11.0", "11.0.2", "11.0.2+9"
|
|
(default: 11)
|
|
-o, --output <directory>
|
|
override output directory;
|
|
this is relative to current PWD
|
|
(default: ./warped)
|
|
--list show available java releases;
|
|
takes into consideration other options:
|
|
"--java-version", "--no-optimize", "--jvm-impl";
|
|
the output may be used to specify concrete
|
|
"--java-version"
|
|
--no-optimize use JRE instead of optimized JDK;
|
|
by default jdeps and jlink are used to create
|
|
optimized JDK for the particular jar;
|
|
JRE is always used for java 8
|
|
--pull check if more recent JDK/JRE distro is available;
|
|
by default latest cached version that matches
|
|
"--java-version" is used
|
|
--linux create binary for Linux
|
|
--macos create binary for macOS
|
|
--windows create binary for Windows
|
|
if no targets are specified then binaries for
|
|
all targets are created
|
|
--jvm-impl jvm implementation: hotspot or openj9
|
|
(default: hotspot)
|
|
--jvm-options <options>
|
|
passed to java like this:
|
|
"java <options> -jar <jar file>";
|
|
use quotes when passing multiple options
|
|
example: '-Xms512m -Xmx1024m'
|
|
-h, --help show this message
|
|
```
|
|
|
|
## Compatibility
|
|
|
|
Tested on the following operating systems:
|
|
|
|
- Ubuntu 18.04
|
|
- macOS Mojave
|
|
- Windows Subsystem for Linux with Ubuntu 14.04
|
|
|
|
## Cache Location
|
|
|
|
Downloaded runtimes and prepared bundles are here:
|
|
|
|
- Linux: `$HOME/.local/share/warp4j`
|
|
- macOS: `$HOME/Library/Application Support/warp4j`
|
|
|
|
To override cache path, set `WARP4J_CACHE` environment variable.
|