Skip to content

Latest commit

 

History

History
53 lines (40 loc) · 1.83 KB

README.md

File metadata and controls

53 lines (40 loc) · 1.83 KB
Raw

Graal Native Starter

Build Status GitHub license

Kotlin application that generates a cross-platform native executable using GraalVM

Generated Artifact is confirmed to be working on all three platforms

  • Linux X 64
  • MacOS X 64
  • Ming X 64

Running the executable

Running the native executable does not require any dependencies or installations. The generated binary contains all the dependencies it needs within itself. As a result, you can execute the binary just from the bash or the shell without having anything else installed - not even JRE!

# Usage (Linux & Mac)
$ ./cli-executable

# Usage (Windows)
$ .\cli-executable

Setup

You are required to do this only if you wish to view/modify the source of the application and build and package it again.

Pre-Requisites

  • JDK ==> 8
  • Gradle ==> 6.8
  • Kotlin ==> 1.5.21
  • GraalVM / Native Image ==> 20.0.0

Ensure that your system-level JDK is pointing to GraalVM. Verify this by doing java -version

Installation

# Clone the repo
$ git clone [email protected]:abbasdgr8/graal-kotlin-starter.git

# Change into the directory
$ cd graal-native-executable

# Initiate the gradle build
$ ./gradlew clean build

Packaging

# Build cross-platform executable from generated jar
$ $GRAALVM_HOME/bin/native-image --report-unsupported-elements-at-runtime -jar build/libs/graal-native-executable-1.0-SNAPSHOT.jar cli-executable --enable-url-protocols=http --no-server

Notes

If you plan to add Java Reflection based libraries to this application, they may not play well with GraalVM.