Build status:
Table of contents
- Introduction
- Tasks
- Configuration
- Launch4jLibraryTask
- Launch4jExternalTask
- Kotlin
- Contributors (see Contributors)
- Version (see VERSION.md)
The gradle-launch4j plugin uses launch4j 3.50 to create windows .exe files for java applications.
This plugin is compatible with the Gradle versions 4.10 and later.
If you still rely on an outdated gradle version [2-4.10[, use the plugin version 2.5.4.
Since version 2.5 this plugin requires *Java 8, as launch4j in version 3.14 and later requires that as well. If you are still forced to work with Java 6, use the plugin version 2.4.9.
There are 2 tasks:
- createExe - Backward compatible task to generate an .exe file. Execute this task to generate an executable. With default settings this creates the executable under
${project.buildDir}/launch4jand puts all runtime libraries into the lib subfolder. - createAllExecutables - Helper task to run all tasks of the
Launch4jExternalTaskandLaunch4jLibraryTasktype.
Launch4j no longer needs to be installed separately, but if you want, you can still use it from the PATH. Since version 2.0 use the Launch4jExternalTask to create your executable.
The configuration follows the structure of the launch4j xml file. The gradle-launch4j plugin tries to pick sensible defaults based on the project. The only required
value is the mainClassName.
An example configuration within your build.gradle for use in all Gradle versions might look like:
plugins {
id 'java'
id 'edu.sc.seis.launch4j' version '3.0.6'
}
launch4j {
mainClassName = 'com.example.myapp.Start'
icon = "${projectDir}/icons/myApp.ico"
}
The same script snippet for using legacy plugin application:
buildscript {
repositories {
gradlePluginPortal()
}
dependencies {
classpath 'edu.sc.seis.launch4j:launch4j:3.0.6'
}
}
repositories {
mavenCentral()
}
apply plugin: 'java'
apply plugin: 'edu.sc.seis.launch4j'
launch4j {
mainClassName = 'com.example.myapp.Start'
icon = "${projectDir}/icons/myApp.ico"
}
If no repository is configured before applying this plugin the Maven central repository will be added to the project.
See the Gradle User guide for more information on how to use a custom plugin and the plugin page for the above settings.
The values configurable within the launch4j extension along with their defaults are:
| Property Name | Default Value | Comment |
|---|---|---|
| String outputDir | "launch4j" | This is the plugin's working path relative to $buildDir. Use the distribution plugin or a custom implementation to copy necessary files to an output location instead of adjusting this property. |
| String libraryDir | "lib" | The library directory next to the created executable, where all dependencies, i.e. libraries, will be copied into. |
| Object copyConfigurable | null | User-defined set of files to copy tolibraryDir (if not set, the default copy logic is used) |
| Set<String> classpath | [] | User-defined classpath property (if not set, the default logic based on the set of files copied to libraryDir is used) |
| String xmlFileName | "launch4j.xml" | |
| String mainClassName | ||
| boolean dontWrapJar | false | |
| String headerType | "gui" | |
| Task jarTask | tasks[jar], if the JavaPlugin is loaded | The jar producing task. See here how to use this for the shadow plugin. |
| String outfile | project.name+'.exe' | |
| String errTitle | "" | |
| String cmdLine | "" | |
| String chdir | '.' | After launching, '.' changes working directory to directory of executable, or '' to not change. Note that env variable %OLDPWD% contains the original working directory and can be passed on launch to your application if needed. |
| String priority | 'normal' | |
| String downloadUrl | "http://java.com/download" | |
| String supportUrl | "" | |
| boolean stayAlive | false | |
| boolean restartOnCrash | false | |
| String manifest | "" | |
| String icon | "" | A relative path from the outfile or an absolute path to the icon file. If you are unsure, use "${projectDir}/path/to/icon.ico" |
| String version | project.version | |
| String textVersion | project.version | |
| String copyright | "unknown" | |
| String companyName | "" | |
| String fileDescription | project.name | |
| String productName | project.name | |
| String internalName | project.name | |
| String trademarks | ||
| String language | "ENGLISH_US" | |
| Set<String> jvmOptions | [ ] | |
| String bundledJrePath | ||
| boolean requires64Bit | false | |
| String jreMinVersion | project.targetCompatibility or the current java version, if the property is not set |
|
| String jreMaxVersion | ||
| Set<String> variables | [ ] | |
| String mutexName | ||
| String windowTitle | ||
| String messagesStartupError | ||
| String messagesJreNotFoundError | ||
| String messagesJreVersionError | ||
| String messagesLauncherError | ||
| String messagesInstanceAlreadyExists | ||
| Integer initialHeapSize | ||
| Integer initialHeapPercent | ||
| Integer maxHeapSize | ||
| Integer maxHeapPercent | ||
| String splashFileName | A relative path from the outfile or an absolute path to the bmp splash file. | |
| boolean splashWaitForWindows | true | |
| Integer splashTimeout | 60 | |
| boolean splashTimeoutError | true | |
| DuplicatesStrategy duplicatesStrategy | DuplicatesStrategy.EXCLUDE | The duplication strategy to use when duplicates are found. See also here. |
| Removed properties | Default Value | Description |
|---|---|---|
| false | ||
| false | use requires64Bit instead | |
| "lib/"+project.tasks[jar].archiveName or "", if the JavaPlugin is not loaded |
||
| "preferJre" | use requiresJdk instead | |
| "64/32" | use requires64Bit instead | |
| use messagesJreNotFoundError instead |
In order to configure the input of the copyL4jLib task set the copyConfigurable property.
The following example shows how to use this plugin hand in hand with the shadow plugin:
launch4j {
outfile = 'TestMain.exe'
mainClassName = project.mainClassName
copyConfigurable = []
jarTask = project.tasks.shadowJar
}
If you use the outdated fatJar plugin the following configuration correctly wires the execution graph:
fatJar {
classifier 'fat'
with jar
manifest {
attributes 'Main-Class': project.mainClassName
}
}
fatJarPrepareFiles.dependsOn jar
launch4j {
outfile = 'TestMain.exe'
mainClassName = project.mainClassName
copyConfigurable = []
jarTask = project.tasks.fatJar
}
This task type can be used to build multiple executables with Launch4j. The default launch4j configuration from how to configure is used for the default values but can be adjusted.
To avoid replacing the resulting xml file or executable on each invocation, xmlFileName and outfile are set to the task name (name.xml and name.exe respectively).
Creating three executables is as easy as:
launch4j {
outfile = 'MyApp.exe'
mainClassName = 'com.example.myapp.Start'
icon = "${projectDir}/icons/myApp.ico"
productName = 'My App'
}
tasks.register('createFastStart', edu.sc.seis.launch4j.tasks.Launch4jLibraryTask) {
outfile = 'FastMyApp.exe'
mainClassName = 'com.example.myapp.FastStart'
icon = "${projectDir}/icons/myAppFast.ico"
fileDescription = 'The lightning fast implementation'
}
tasks.register('MyApp-memory', edu.sc.seis.launch4j.tasks.Launch4jLibraryTask) {
fileDescription = 'The default implementation with increased heap size'
maxHeapPercent = 50
}
Running the createAllExecutables task will create the following executables in the launch4j folder located in the buildDir:
- MyApp.exe
- FastMyApp.exe
- MyApp-memory.exe
The section from above applies to this task, too. This task type has the following additional property:
- String launch4jCmd = "launch4j"
In order to use a launch4j instance named 'launch4j-test' located in the PATH create a task like the following:
launch4j {
mainClassName = 'com.example.myapp.Start'
}
task createMyApp(type: edu.sc.seis.launch4j.tasks.Launch4jExternalTask) {
launch4jCmd = 'launch4j-test'
outfile = 'MyApp.exe'
}
To use a different launch4j binary instead of the default one, you can provide it as follows. Use your desired version instead of 3.50.
dependencies {
launch4jBin 'net.sf.launch4j:launch4j:3.50:workdir-win32'
}
To get started using this plugin from a kotlin build script the above example from the section Launch4jLibraryTask would be written as:
tasks.withType<edu.sc.seis.launch4j.tasks.DefaultLaunch4jTask> {
outfile.set("${appName}.exe")
mainClassName.set(mainClass)
icon.set("$projectDir/icons/myApp.ico")
productName.set("My App")
}
tasks.register<edu.sc.seis.launch4j.tasks.Launch4jLibraryTask>("createFastStart") {
outfile.set("FastMyApp.exe")
mainClassName.set("com.example.myapp.FastStart")
icon.set("$projectDir/icons/myAppFast.ico")
fileDescription.set("The lightning fast implementation")
}
tasks.register<edu.sc.seis.launch4j.tasks.Launch4jLibraryTask>("MyApp-memory") {
fileDescription.set("The default implementation with increased heap size")
maxHeapPercent.set(50)
}To get insight into the launch4j creation process start a launch4j task, e.g. createExe, createExecutables or your custom task, with the script parameter -Pl4j-debug. This will copy the created xml into ${buildDir}/tmp/${task.name}.
In order to debug the created executable call it with the command line argument --l4j-debug. This will create the log file launch4j.log next to the executable.
When you report a bug and it got fixed, you will have access to some -SNAPSHOT version.
Adjust your buildscript to use the artifactory OSS repo:
buildscript {
repositories {
maven { url 'https://boegl.jfrog.io/artifactory/snapshots-gradle-dev-local/' }
}
dependencies {
classpath 'edu.sc.seis.launch4j:launch4j:latest.integration'
}
}
apply plugin: 'edu.sc.seis.launch4j'- Sebastian Bögl (Maintainer)
- Philip Crotwell (Creator)
See contributors for a complete list.
See VERSION.md for more information.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent