Page History
Description
JApplication is a task for assembling native launchers of Java applications for a number of target platforms. Currently supports native launchers for Mac and Windows operating systems and also a "java launcher" - a single jar file that can be run via "java -jar file.jar".
OS Strategies
- Java: builds a single runnable jar file out of a collection of jar files.
- Mac: builds a XYZ.app bundle that includes all jar dependencies.
- Windows: Performs a Java build and creates an NSIS launcher for the runnable jar. Both
".exe"and".jar"files are required to be in the same directory for the launcher to work.
OS Requirements
- Mac launcher can be built on Mac only, as it requires a JavaApplicationStab file.
- Windows launcher can be built on Windows only.
- Java launcher can be assembled on any platform and has no prerequisites.
Parameters
Attribute | Description | Required | Platforms |
|---|---|---|---|
name | The name of the application without OS-specific extension | yes |
|
mainClass | Main Java class | yes |
|
os | A family of operating systems. Currently supported values are "mac", "windows" and "java" | no (will use build machine os if ommitted; if the os is not supported, will use "java") |
|
destDir | A destination directory where the application launcher should be installed | no (will use |
|
longName | An optional string identifying the application human-readable name. If not specified, "name" is used. | no |
|
icon | Platform-specific icon file (usually "*.ico" on Windows and "*.icns" on Mac) | no | mac,windows |
jvm | Minimal version of the Java Virtual machine required. | no (default is "1.4+") | mac |
jvmOptions | Optional parameters to pass to the JVM, such as memory settings, etc. | no | mac,windows |
version | Product version string | no (default 0.0) | mac |
Nested Elements
lib
The FileSet specifying jar files to be included in the application.
Examples
Loading task:
| No Format |
|---|
<taskdef name="japplication" classname="org.objectstyle.woproject.ant.JApplication"/> |
Building a Windows application, resulting in "MyApp.exe" launcher that starts "MyApp.jar" file.
| No Format |
|---|
<japplication name="MyApp" destDir="dist" mainClass="org.example.Main" os="windows"> <lib dir="lib" includes="**/*.jar"/> </japplication> |