Launch4j

A Maven plugin which wraps Launch4j

Code Quality Rank: L2

Programming language: Java

License: GNU General Public License v3.0 or later

Tags: Distribution    

Latest version: v1.7.25

README

Launch4j Maven Plugin

Originally hosted at http://9stmaryrd.com/tools/launch4j-maven-plugin/

• Documentation
• Version Notes
• FAQ

Documentation

Please check [this](src/main/resources/README.adoc) document for more detailed info on how to use the plugin. Please also check Launch4j's Configuration file page. The full list of all the parameters is available [here](src/main/resources/MOJO.md)

NOTE: Since version 2.0.x this plugin requires to be used with Maven 3.6.x at least.

Version Notes

Version notes 2.1.3 - 2022-10-24

• allows to skip execution of the plugin using either <skip>true</skip> configuration option or -DskipLaunch4j property, see [#190](../../pull/190)

Version notes 2.1.1 - 2021-05-04

• creates parent folder if outfile was configured, see [#141](../../issues/141)

Version notes 2.1.0 - 2021-05-04

• upgrades Maven API to version 3.8.1 (it should be compatible with Maven 3.6.x), see [#132](../../pull/132), [#133](../../pull/133), [#134](../../pull/134), [#135](../../pull/135), [#136](../../pull/136)

Version notes 2.0.1 - 2021-03-21

• fixes problem with NPE, see [#128](../../issues/128)

Version notes 2.0.0 - 2021-03-17

DO NOT USE THIS VERSION

• uses Launch4j version 3.14 (which requires Java 8), see [#126](../../pull/126)
• switches to Java 8 as minimal supported version

Version notes 1.7.25

• creates parent directories of an obj file, see [#99](../../pull/99)

Version notes 1.7.24

• adds a threadSafe flag to the Mojo to properly mark that the plugin is thread safe, see [#72](../../issues/72)

Version notes 1.7.23

• adds a parallelExecution flag that will allow to run only one instance of the plugin in the given time, see [#72](../../issues/72)

Version notes 1.7.22

• upgrades to Launch4j version 3.12, see [#75](../../issues/75)

Version notes 1.7.21

• fixes issue with detecting OSX, see [#58](../../issues/58)

Version notes 1.7.20

• uses the linux64 platform when run on 64-bit Linux, see [#59](../../pull/59)

Version notes 1.7.19

• upgrades to the version 3.11 of Launch4j

Version notes 1.7.18

• reverts changes introduced in 1.7.17, see [#55](../../pull/55)

Version notes 1.7.17

• adds support for unwrapped jar, see [#55](../../pull/55)

Version notes 1.7.16

• detects different OSX versions to properly use proper binary bundle, see [#54](../../pull/54)

Version notes 1.7.15

• allows override some properties loaded from an external Launch4j config file, see [#49](../../issues/49)

Version notes 1.7.14

• fixes issue with setting language, see [#50](../../issues/50)

Version notes 1.7.13

• upgrades maven plugins to latest versions, see [#47](../../issues/47)

Version notes 1.7.12

• adds support for missing options, see [#45](../../issues/45)
  • language - please use one of the values as defined for the <language/> tag
  • trademarks - a free text used as a trademarks

Version notes 1.7.11

• upgrades to Launch4j version 3.9

Version notes 1.7.10

• fixes broken <configuration/> when not using <infile/>

Version notes 1.7.9

• adds capability of loading Launch4j native configuration file xml <configuration> <infile>${project.basedir}/src/main/resources/my-app-config.xml</infile> </configuration> By default it will take from ${project.basedir}/src/main/resources/${project.artifactId}-launch4j.xml. Plugin execution goal should be set to install. It's an optional configuration, you can either use your existing configuration as it was in previous version or use native Launch4j config file via <infile>.

Version notes 1.7.8

• fixes issue with spaces in path to maven repository on non-Windows systems, see [#27](../../issues/27), [#28](../../issues/28)

Version notes 1.7.7

• once again fixes problem with including dependencies in scope runtime (now it should be the final solution), see [#5](../../issues/5)
• adds support for bundledJreAsFallback and bundledJre64Bit properties, see [#23](../../issues/23)
• upgrades Launch4j to 3.8.0, see [#21](../../issues/21)

Version notes 1.7.6

• fixes again problem with including dependencies in scope runtime, see [#5](../../issues/5)

Version notes 1.7.5

• allows add custom headers and libraries to working dir [#22](../../pull/22)

Version notes 1.7.4

• fixes type in default value for outfile parameter [#17](../../pull/17)

Version notes 1.7.3

• uses Maven annotation instead of JavaDoc parameters [#15](../../pull/15)
• upgrades Maven plugins [#15](../../pull/15)
• converts tabs to spaces [5b0619](../../commit/5b0619)

Version notes 1.7.2

• adds support for restartOnCrash Launch4j's option [#14](../../pull/14)

Version notes 1.7.1

• launch4j's abeille dependency was excluded [#11](../../pull/11)
• versions of several plugins were updated [#11](../../pull/11)
• tabs were converted to spaces [#11](../../pull/11)

Version notes 1.7

• uses the latest version of Launch4j (3.5.0)
• contains support for runtimeBits, see [#6](../../issues/6)
• fixes problem with including dependencies in scope runtime, see [#5](../../issues/5)

Version notes 1.6

• dropped Launch4j source and based on artifacts from Maven Central, see [#8](../../issues/8)
• uses the latest version of Launch4j (3.4.0)
• at least Java 1.7 is required

FAQ

Q: I cannot build my project because dsol-xml dependency is missing?

A: Add this repository to your ~/.m2/settings.xml

<repositories>
    <repository>
        <id>dsol-xml</id>
        <name>Simulation @ TU Delft</name>
        <url>http://simulation.tudelft.nl/maven/</url>
    </repository>
</repositories>

Q: Where can I find -SNAPSHOT builds?

A: Use the Sonatype OSS repo

<repositories>
    <repository>
        <id>sonatype-nexus-snapshots</id>
        <name>Sonatype Nexus Snapshots</name>
        <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
        <releases>
            <enabled>false</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

Q: Can I use Launch4j on 64bit OS?

A: Yes but you will have to install these libs to avoid problems:

• lib32z1
• lib32ncurses5
• lib32bz2-1.0 (has been ia32-libs in older Ubuntu versions)
• zlib.i686
• ncurses-libs.i686
• bzip2-libs.i686

See [#4](../../issues/4) for more details.

Q: How can I skip execution of the plugin?

A: You can either use <skip>true</skip> configuration option or provide -DskipLaunch4j property to JVM

See PR [#190](../../pull/190) for more details.