Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sergemerzliakov/installmation

Creates Cross Platform Java Application Installers via Graphical User Interface
https://github.com/sergemerzliakov/installmation

gui installer java javafx-application jpackage kotlin

Last synced: about 1 month ago
JSON representation

Creates Cross Platform Java Application Installers via Graphical User Interface

Awesome Lists containing this project

README 

        
![](src/main/resources/image/logo_small.png)

## Overview



Installmation is a GUI tool, similar to exe4j, which generates installers for Mac and Windows using Java 11+ JDK jpackage tool. Linux version builds and runs but I have done very little testing.



I am writing it in Kotlin.



The tool will provide the following:

    

    1. Ability to create installable image 

    2. Ability to create complete installer

    3. Ability to generate batch scripts for the relevant JPackage commands

    4. Ability to list the Java 9 module dependencies for an application (Jdeps Tool Dialog)

    

No doubt plugins for doing this in Gradle or Maven will appear, and this is meant 

to complement those approaches.



### Release 0.2.5 ###



Full installers for Mac and Windows can be found at https://github.com/SergeMerzliakov/installmation/releases



These installers are created by Installmation itself.



#### What's New

* JVM arguments (for deployed JVM) can now be added



### Tutorial ###

A basic walkthrough can be found at https://thickclient.blog/2019/12/23/installmation-an-installer-generator-for-java-11-apps/

 

### Running from the Command Line

You can run the latest version (rudimentary so far) with the gradle command (under Java 11 or later)

 

    gradlew runApp



These will build installers, but testing has been limited, so feedback would be welcome, as I am sure there 

are use cases which I have not covered.



### Prerequisites



    1. JDK 11+

    2. OpenJFX 11+

    3. WiX Toolkit (windows only)



You do NOT need gradle installed - the gradlew script will automatically download the correct gradle version.



### Setup



1. Download JavaFX SDK 13.0.1 or later (https://gluonhq.com/products/javafx/)

2. Download JavaFX jmods 13.0.1 or later (https://gluonhq.com/products/javafx/)

3. Install them together in the same root dir e.g. /somewhere/JavaFX/13

4. (Windows) Download WiX toolset from https://github.com/wixtoolset/wix3/releases and add to PATH

    * For some versions of Wix (<3.14), you will need to install .NET 3.5 (https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net35-sp1-web-installer)

5. Create local.properties with JFX version and path to root dir. Here is an OSX sample:



        JFX_VERSION=13

        JFX_PATH=/somewhere/JavaFX/13

        JDK=/Library/Java/JavaVirtualMachines/jdk-11.0.2.jdk  # this is for unit testing and must be v11+



Just to reiterate, JFX_PATH variable path should contain both jars and jmod files:



    /libs

    /jmods



#### Unit Testing

The unit tests run lots of Testfx tests, some of which tests dialogs which run JDK tools like jdeps. These tests require various binaries

like JDK, JavaFX libraries as input parameters, which cannot versioned inside the repo. 



So on first startup for these unit tests, the object org.installmation.TestingBootstrap checks for local configuration 

in **local.properties**, to make sure JavaFX and JDK are setup.

 

    /local.properties



The tests run in `headless` mode by default. To run tests and show their execution with the TestFX robot use the `showTests` environment variable



    gradlew test -DshowTests=true



### Sample Configurations



The `samples` directory contains sample configuration files to help with troubleshooting.