To edit or add content to this Wiki, you can simply create a new account at http://wocommunity.org/account
.
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:
<taskdef name="japplication" classname="org.objectstyle.woproject.ant.JApplication"/>
Building a Windows application, resulting in "MyApp.exe" launcher that starts "MyApp.jar" file.
<japplication name="MyApp" destDir="dist" mainClass="org.example.Main" os="windows"> <lib dir="lib" includes="**/*.jar"/> </japplication>