Skip to Content

Changes for page JApplication

Last modified by Andrus Adamchik on 2006/12/10 12:40
From version 45.1
edited by Andrus Adamchik
on 2006/09/16 12:56
Change comment: There is no comment for this version
To version 47.1
edited by Andrus Adamchik
on 2006/09/16 13:40
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -2,12 +2,50 @@
2 2  
3 3  == Description ==
4 4  
5 -//JApplication// is a task for assembling native launchers of Java applications for a number of target platforms. Currently supports Mac and Winodws operating systems.
5 +//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"--##--.--
6 6  
7 -== Prerequisites and OS Specifics ==
7 +== Build Prerequisites and OS Specifics ==
8 8  
9 -* Mac launcher can be assmebled on any platform and has no prerequisites
9 +* Java launcher can be assembled on any platform and has no prerequisites.
10 +* Mac launcher can be built on Mac, as it requires a JavaApplicationStab file.
10 10  * Windows launcher can currently be build on Windows only.
11 11  * Windows launcher requires [[NSIS>>http://nsis.sourceforge.net/Main_Page]] to be installed on the build machine.
12 12  
13 13  == Parameters ==
15 +
16 +|=Attribute|=Description|=Required|=Platforms
17 +|name|The name of the application without OS-specific extension|yes|
18 +|mainClass|Main Java class|yes|
19 +|os|A family of operating systems. Currently supported values are "mac", "windows" and "java"|no (will use "java" if ommitted)|
20 +|destDir|A destination directory where the application launcher should be installed|no (will use ##"$builddir"## if omitted)|
21 +|description|An optional short string identifying the application. If not specified, "name" is used|no|
22 +|icon|Platform-specific icon file (usually ".ico" on Windows and ".icns" on Mac)|no|mac,windows
23 +|jvm|Minimal version of the Java Virtual machine required.|no|mac
24 +|jvmOptions|Optional parameters to pass to the JVM, such as memory settings, etc.|no|mac
25 +
26 +== Nested Elements ==
27 +
28 +=== fileset ===
29 +
30 +The [[FileSet>>http://ant.apache.org/manual/CoreTypes/fileset.html]] specifying Java classes and resources to be included in the application.
31 +
32 +=== lib ===
33 +
34 +The [[FileSet>>http://ant.apache.org/manual/CoreTypes/fileset.html]] specifying jar files to be included in the application.
35 +
36 +== Examples ==
37 +
38 +Loading task:
39 +
40 +{{noformat}}
41 +<taskdef name="japplication" classname="org.objectstyle.woproject.ant.JApplication"/>
42 +{{/noformat}}
43 +
44 +Building a Windows application, resulting in "MyApp.exe" launcher that starts "MyApp.jar" file.
45 +
46 +{{noformat}}
47 +<japplication name="MyApp" destDir="dist" mainClass="org.example.Main" os="windows">
48 + <fileset dir="${build}/classes"/>
49 + <lib dir-"lib" includes="**/*.jar"/>
50 +</japplication>
51 +{{/noformat}}