Wiki source code of JApplication
Version 69.1 by Andrus Adamchik on 2006/09/16 14:41
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | //(unreleased as of 09/16/2006)// | ||
| 2 | |||
| 3 | == Description == | ||
| 4 | |||
| 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 | |||
| 7 | == Build Prerequisites and OS Specifics == | ||
| 8 | |||
| 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. | ||
| 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. | ||
| 13 | |||
| 14 | == 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 build machine os if ommitted; if the os is not supported, will use "java")| | ||
| 20 | |destDir|A destination directory where the application launcher should be installed|no (will use ##"$basedir"## if omitted)| | ||
| 21 | |longName|An optional string identifying the application human-readable name. 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 | |nsisHome|Location of NSIS installation. Ignored except on Windows.|no (default is "C:rogram FilesSIS")|windows | ||
| 26 | |||
| 27 | == Nested Elements == | ||
| 28 | |||
| 29 | === fileset === | ||
| 30 | |||
| 31 | The [[FileSet>>http://ant.apache.org/manual/CoreTypes/fileset.html]] specifying Java classes and resources to be included in the application. | ||
| 32 | |||
| 33 | === lib === | ||
| 34 | |||
| 35 | The [[FileSet>>http://ant.apache.org/manual/CoreTypes/fileset.html]] specifying jar files to be included in the application. | ||
| 36 | |||
| 37 | == Examples == | ||
| 38 | |||
| 39 | Loading task: | ||
| 40 | |||
| 41 | {{noformat}} | ||
| 42 | <taskdef name="japplication" classname="org.objectstyle.woproject.ant.JApplication"/> | ||
| 43 | {{/noformat}} | ||
| 44 | |||
| 45 | Building a Windows application, resulting in "MyApp.exe" launcher that starts "MyApp.jar" file. | ||
| 46 | |||
| 47 | {{noformat}} | ||
| 48 | <japplication name="MyApp" destDir="dist" mainClass="org.example.Main" os="windows"> | ||
| 49 | <fileset dir="${build}/classes"/> | ||
| 50 | <lib dir="lib" includes="**/*.jar"/> | ||
| 51 | </japplication> | ||
| 52 | {{/noformat}} |