Launch4j Maven Plugin
Originally hosted at http://9stmaryrd.com/tools/launch4j-maven-plugin/
Documentation
Please check this 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
NOTE: Since version 2.0.x this plugin requires to be used with Maven 3.6.x at least.
Version Notes
Please check the releases page for the exact versions notes
Version notes 2.3.3 - 2023-03-11
- updates maven wrapper to official 3.1.1, adds sha-512 & sha-256 checksums, adds a profiler extension, see PR #252
Version notes 2.3.2 - 2023-01-30
- fixes broken Project Reports when running
maven-project-info-reports-plugin
, see Issue #223 and PR #227
Version notes 2.3.1 - 2023-01-16
- logs only warnings instead of throwing exception, when cannot fulfill default values for
<VersionInfo>
(no configuration data required by the formula), see Issue #213 and PR #216
Version notes 2.3.0 - 2023-01-06
- provides default values for plugin configuration, especially for
<VersionInfo>
, see Issue #98 - adds a
disableVersionInfoDefaults
parameter to be able to disable provided defaults, see PR #205 - adds documentation notes regarding a new defaults, see VERSIONINFO.md
- throwing exceptions with detailed description of default values formula, when cannot fulfill default values (no configuration data for a formula), it helps plugin user with debugging what is wrong
Version notes 2.2.0 - 2022-11-24
- upgrades Launch4j to version 3.50 and adopts config to the bew requirements, see Issue #199 and PR #200 for more details what has to be changed
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
Version notes 2.1.1 - 2021-05-04
- creates parent folder if
outfile
was configured, see #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, #133, #134, #135, #136
Version notes 2.0.1 - 2021-03-21
- fixes problem with NPE, see #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
- switches to Java 8 as minimal supported version
Version notes 1.7.25
- creates parent directories of an obj file, see #99
Version notes 1.7.24
- adds a
threadSafe
flag to the Mojo to properly mark that the plugin is thread safe, see #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
Version notes 1.7.22
- upgrades to Launch4j version 3.12, see #75
Version notes 1.7.21
- fixes issue with detecting OSX, see #58
Version notes 1.7.20
- uses the
linux64
platform when run on 64-bit Linux, see #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
Version notes 1.7.17
- adds support for unwrapped jar, see #55
Version notes 1.7.16
- detects different OSX versions to properly use proper binary bundle, see #54
Version notes 1.7.15
- allows override some properties loaded from an external Launch4j config file, see #49
Version notes 1.7.14
- fixes issue with setting
language
, see #50
Version notes 1.7.13
- upgrades maven plugins to latest versions, see #47
Version notes 1.7.12
- adds support for missing options, see #45
language
- please use one of the values as defined for the<language/>
tagtrademarks
- 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
<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
Version notes 1.7.7
- once again fixes problem with including dependencies in scope
runtime
(now it should be the final solution), see #5 - adds support for
bundledJreAsFallback
andbundledJre64Bit
properties, see #23 - upgrades Launch4j to 3.8.0, see #21
Version notes 1.7.6
- fixes again problem with including dependencies in scope
runtime
, see #5
Version notes 1.7.5
- allows add custom headers and libraries to working dir #22
Version notes 1.7.4
- fixes type in default value for
outfile
parameter #17
Version notes 1.7.3
- uses Maven annotation instead of JavaDoc parameters #15
- upgrades Maven plugins #15
- converts tabs to spaces 5b0619
Version notes 1.7.2
- adds support for
restartOnCrash
Launch4j's option #14
Version notes 1.7.1
- launch4j's
abeille
dependency was excluded #11 - versions of several plugins were updated #11
- tabs were converted to spaces #11
Version notes 1.7
- uses the latest version of Launch4j (3.5.0)
- contains support for
runtimeBits
, see #6 fixes problem with including dependencies in scoperuntime
, see #5
Version notes 1.6
- dropped Launch4j source and based on artifacts from Maven Central, see #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 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 for more details.