Gradle IzPack plugin

Gradle plugin that provides support for packaging applications for the Java platform via IzPack.

License

License

Categories

Categories

Gradle Build Tools IzPack Distribution
GroupId

GroupId

com.bmuschko
ArtifactId

ArtifactId

gradle-izpack-plugin
Last Version

Last Version

3.1
Release Date

Release Date

Type

Type

jar
Description

Description

Gradle IzPack plugin
Gradle plugin that provides support for packaging applications for the Java platform via IzPack.
Project URL

Project URL

https://github.com/bmuschko/gradle-izpack-plugin
Source Code Management

Source Code Management

https://github.com/bmuschko/gradle-izpack-plugin

Download gradle-izpack-plugin

How to add to project

<!-- https://jarcasting.com/artifacts/com.bmuschko/gradle-izpack-plugin/ -->
<dependency>
    <groupId>com.bmuschko</groupId>
    <artifactId>gradle-izpack-plugin</artifactId>
    <version>3.1</version>
</dependency>
// https://jarcasting.com/artifacts/com.bmuschko/gradle-izpack-plugin/
implementation 'com.bmuschko:gradle-izpack-plugin:3.1'
// https://jarcasting.com/artifacts/com.bmuschko/gradle-izpack-plugin/
implementation ("com.bmuschko:gradle-izpack-plugin:3.1")
'com.bmuschko:gradle-izpack-plugin:jar:3.1'
<dependency org="com.bmuschko" name="gradle-izpack-plugin" rev="3.1">
  <artifact name="gradle-izpack-plugin" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.bmuschko', module='gradle-izpack-plugin', version='3.1')
)
libraryDependencies += "com.bmuschko" % "gradle-izpack-plugin" % "3.1"
[com.bmuschko/gradle-izpack-plugin "3.1"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

Gradle IzPack plugin Build Status

IzPack Logo

Over the past couple of years this plugin has seen many releases. Thanks to everyone involved! Unfortunately, I don't have much time to contribute anymore. In practice this means far less activity, responsiveness on issues and new releases from my end.
I am actively looking for contributors willing to take on maintenance and implementation of the project. If you are interested and would love to see this plugin continue to thrive, shoot me a mail.

The plugin provides a one-stop solution for packaging, distributing and deploying applications for the Java platform using IzPack.

Usage

To use the IzPack plugin, include in your build script:

plugins {
    id 'com.bmuschko.izpack'
}

The plugin JAR needs to be defined in the classpath of your build script. It is directly available on Bintray. Alternatively, you can download it from GitHub and deploy it to your local repository. The following code snippet shows an example on how to retrieve it from Bintray:

buildscript {
    repositories {
        jcenter()
    }

    dependencies {
        classpath 'com.bmuschko:gradle-izpack-plugin:3.1'
    }
}

To define the IzPack standalone compiler dependency please use the izpack configuration name in your dependencies closure.

For IzPack v5

dependencies {
    izpack 'org.codehaus.izpack:izpack-ant:5.1.3'
}

or for IzPack v4

dependencies {
    izpack 'org.codehaus.izpack:izpack-standalone-compiler:4.3.5'
}

Tasks

The IzPack plugin defines the following tasks:

  • izPackCreateInstaller: Creates an IzPack-based installer.

Convention properties

The IzPack plugin defines the following convention properties in the izpack closure:

  • baseDir: The base directory of compilation process (defaults to build/assemble/izpack).
  • installerType: The installer type (defaults to standard). You can select between standard and web.
  • installFile: The location of the IzPack installation file (defaults to src/main/izpack/install.xml).
  • outputFile: The installer output directory and filename (defaults to build/distributions/<projectname>-<version>-installer.jar).
  • compression: The compression of the installation (defaults to default). You can select between default, deflate and raw.
  • compressionLevel: The compression level of the installation (defaults to -1 for no compression). Valid values are -1 to 9.
  • appProperties: The Map of application properties to be used for the compilation process (defaults to empty Map).

Example

izpack {
    baseDir = file("$buildDir/assemble/izpack")
    installFile = file('installer/izpack/installer.xml')
    outputFile = file("$buildDir/distributions/griffon-${version}-installer.jar")
    compression = 'deflate'
    compressionLevel = 9
    appProperties = ['app.group': 'Griffon', 'app.name': 'griffon', 'app.title': 'Griffon',
                     'app.version': version, 'app.subpath': "Griffon-$version"]
}

Versions

Version
3.1
3.0