public/warp4j
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 3 Wiki Activity

feature/creating_macos_application_bundle #27

Merged
David merged 4 commits from feature/creating_macos_application_bundle into develop 2024-05-31 15:31:37 +02:00
Conversation 0 Commits 4 Files Changed 3 +99 -74
3 changed files with 99 additions and 74 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 85898ce5f2 - Show all commits

8
CHANGELOG.md
View File

@ -6,17 +6,21 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
### Changed
- Improved macOS runnable execution in the tar.gz file. The executable file is now placed inside a folder named `application.app`, allowing it to be launched with a double-click.
## [1.0.0] - 2024-05-20
### Added
- Install script improved to run with /bin/sh
- Dockerfile changed to use install.sh script (Works on x64 and aarch64 architecture)
- Dockerfile_x64 with old build script for tests
- Script warp4j improved to support to run on aarch64 architecture
### Changed
- Script warp4j improved to support running on aarch64 architecture
## [origin warp4j] - 2019-02-28
- See origin repository: https://github.com/guziks/warp4j
[unreleased]: https://git.phoenix.ipv64.de/public/warp4j/compare/master...HEAD
[1.0.0]: https://git.phoenix.ipv64.de/public/warp4j/compare/stable...master
[origin warp4j]: https://github.com/guziks/warp4j
[origin warp4j]: https://github.com/guziks/warp4j

108
README.md
View File

@ -4,12 +4,12 @@ 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://git.phoenix.ipv64.de/public/warp)
- works on Linux, macOS and Windows (with Windows Subsystem for Linux)
- supports cross "compilation"
- does not require neither JDK nor JRE installed
- Downloads Java runtimes automatically
- Makes runtimes optimized for your application
- Creates self-contained binaries for Linux, macOS, and Windows using [warp-packer](https://git.phoenix.ipv64.de/public/warp)
- Works on Linux, macOS, and Windows (with Windows Subsystem for Linux)
- Supports cross "compilation"
- Does not require either JDK or JRE installed
## TL;DR
@ -17,19 +17,19 @@ Just put both `warp4j` and `warp-packer` somewhere in your PATH and run `warp4j
## Install
Curl one-liner installs latest versions of both `warp4j` and `warp-packer`:
Curl one-liner installs the latest versions of both `warp4j` and `warp-packer`:
```
```sh
bash -c "$(curl -fsSL https://git.phoenix.ipv64.de/public/warp4j/raw/branch/master/install.sh)"
```
This script will show missing dependencies (if there are any), they must be installed with your package manager.
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
```
```sh
$ ls
my-app.jar
@ -53,62 +53,84 @@ my-app-windows-x64.zip
See help:
```
$ wapr4j --help
```sh
$ warp4j --help
Usage: warp4j [options] <app.jar>
Turn JAR (java archive) into self-contained executable
Turn JAR (java archive) into a self-contained executable
Options:
-j, --java-version <version>
override JDK/JRE version
examples: "17", "17.0", "17.0.2", "17.0.2+9"
Override JDK/JRE version
Examples: "17", "17.0", "17.0.2", "17.0.2+9"
(default: 17)
-cp, --class-path <classpath>
adds additional classpaths to the jdeps call
--auto-class-path extract and get class-path values from jar file
ignored when -cp, --class-path is set
--spring-boot extract and get class-path values from
Adds additional classpaths to the jdeps call
--auto-class-path Extract and get class-path values from jar file
Ignored when -cp, --class-path is set
--spring-boot Extract and get class-path values from
Spring-Boot application jar file
ignored when -cp, --class-path is set
Ignored when -cp, --class-path is set
-o, --output <directory>
override output directory;
this is relative to current PWD
Override output directory;
This is relative to current PWD
(default: ./warped)
-p, --prefix <prefix>
if set, warp-packer will use the prefix
If set, warp-packer will use the prefix
as target folder in which the
application should be extracted
--list show available java releases;
takes into consideration other options:
--list Show available java releases;
Takes into consideration other options:
"--java-version", "--no-optimize", "--jvm-impl";
the output may be used to specify concrete
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
--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
--pull Check if more recent JDK/JRE distro is available;
By default latest cached version that matches
"--java-version" is used
to get the classpath for jdeps call
--linux create binary for Linux
--macos create binary for macOS
--windows create binary for Windows
if no targets are specified then binaries for
--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-options <options>
passed to java like this:
Passed to java like this:
"java <options> -jar <jar file>";
use quotes when passing multiple options
example: '-Xms512m -Xmx1024m'
-s, --silent using javaw instead of java for windows
-h, --help show this message
Use quotes when passing multiple options
Example: '-Xms512m -Xmx1024m'
-s, --silent Using javaw instead of java for windows
-h, --help Show this message
```
### Running on macOS
For macOS, the executable is placed inside a folder with the `.app` extension within the tar.gz file. This allows the application to be launched with a double-click.
To run the application:
1. **From the Executable**:
- Navigate to the `warped` folder.
- Find the `my-app-macos-x64` executable.
- Note: Double-clicking on “my-app-macos-x64” does not work directly because macOS does not know which program to use to open the application.
- To run it, open the terminal and navigate to the `warped` folder:
```sh
cd /path/to/warped
```
- Run the executable from the terminal:
```sh
./my-app-macos-x64
```
2. **From the tar.gz File**:
- Extract the `my-app-macos-x64.tar.gz` file.
- Navigate to the extracted folder: `my-app-macos-x64`.
- You will find a folder named `my-app.app`. For macOS this is now an executable file.
- Double-click on `my-app.app` to run the application.
## Compatibility
Tested on the following operating systems:
@ -122,4 +144,4 @@ 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.
To override cache path, set `WARP4J_CACHE` environment variable.

57
warp4j
View File

@ -4,53 +4,52 @@ function print_help {
echo
echo 'Usage: warp4j [options] <app.jar>'
echo
echo 'Turn JAR (java archive) into self-contained executable'
echo 'Turn JAR (java archive) into a self-contained executable'
echo
echo 'Options:'
echo ' -j, --java-version <version>'
echo ' override JDK/JRE version'
echo ' examples: "17", "17.0", "17.0.2", "17.0.2+9"'
echo ' Override JDK/JRE version'
echo ' Examples: "17", "17.0", "17.0.2", "17.0.2+9"'
echo ' (default: 17)'
echo ' -cp, --class-path <classpath>'
echo ' adds additional classpaths to the jdeps call'
echo ' --auto-class-path extract and get class-path values from jar file'
echo ' ignored when -cp, --class-path is set'
echo ' --spring-boot extract and get class-path values from'
echo ' Adds additional classpaths to the jdeps call'
echo ' --auto-class-path Extract and get class-path values from jar file'
echo ' Ignored when -cp, --class-path is set'
echo ' --spring-boot Extract and get class-path values from'
echo ' Spring-Boot application jar file'
echo ' ignored when -cp, --class-path is set'
echo ' Ignored when -cp, --class-path is set'
echo ' -o, --output <directory>'
echo ' override output directory;'
echo ' this is relative to current PWD'
echo ' Override output directory;'
echo ' This is relative to current PWD'
echo ' (default: ./warped)'
echo ' -p, --prefix <prefix>'
echo ' if set, warp-packer will use the prefix'
echo ' as target folder in which the '
echo ' If set, warp-packer will use the prefix'
echo ' as target folder in which the'
echo ' application should be extracted'
echo ' --list show available java releases;'
echo ' takes into consideration other options:'
echo ' --list Show available java releases;'
echo ' Takes into consideration other options:'
echo ' "--java-version", "--no-optimize", "--jvm-impl";'
echo ' the output may be used to specify concrete'
echo ' The output may be used to specify concrete'
echo ' "--java-version"'
echo ' --no-optimize use JRE instead of optimized JDK;'
echo ' by default jdeps and jlink are used to create'
echo ' --no-optimize Use JRE instead of optimized JDK;'
echo ' By default jdeps and jlink are used to create'
echo ' optimized JDK for the particular jar;'
echo ' JRE is always used for java 8'
echo ' --pull check if more recent JDK/JRE distro is available;'
echo ' by default latest cached version that matches'
echo ' --pull Check if more recent JDK/JRE distro is available;'
echo ' By default latest cached version that matches'
echo ' "--java-version" is used'
echo ' to get the classpath for jdeps call'
echo ' --linux create binary for Linux'
echo ' --macos create binary for macOS'
echo ' --windows create binary for Windows'
echo ' if no targets are specified then binaries for'
echo ' --linux Create binary for Linux'
echo ' --macos Create binary for macOS'
echo ' --windows Create binary for Windows'
echo ' If no targets are specified then binaries for'
echo ' all targets are created'
echo ' --jvm-options <options>'
echo ' passed to java like this:'
echo ' Passed to java like this:'
echo ' "java <options> -jar <jar file>";'
echo ' use quotes when passing multiple options'
echo " example: '-Xms512m -Xmx1024m'"
echo ' -s, --silent using javaw instead of java for windows'
echo ' -h, --help show this message'
echo ' Use quotes when passing multiple options'
echo " Example: '-Xms512m -Xmx1024m'"
echo ' -s, --silent Using javaw instead of java for windows'
echo ' -h, --help Show this message'
exit
}