Wiki source code of JApplication
Version 47.1 by Andrus Adamchik on 2006/09/16 13:40
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
26.1 | 1 | //(unreleased as of 09/16/2006)// |
| 2 | |||
| 3 | == Description == | ||
| 4 | |||
| |
46.1 | 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"--##--.-- |
| |
26.1 | 6 | |
| |
46.1 | 7 | == Build Prerequisites and OS Specifics == |
| |
26.1 | 8 | |
| |
46.1 | 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. | ||
| |
36.1 | 11 | * Windows launcher can currently be build on Windows only. |
| 12 | * Windows launcher requires [[NSIS>>http://nsis.sourceforge.net/Main_Page]] to be installed on the build machine. | ||
| |
26.1 | 13 | |
| 14 | == Parameters == | ||
| |
46.1 | 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}} |