Skip to Content

Wiki source code of WOApplication

Version 49.1 by Andrew Lindesay on 2006/10/24 16:57
Hide last authors
Paul Hoadley 17.1 1 = WOApplication Task Manual =
2
3 This has been transcribed by [[Andrew Lindesay>>http://www.lindesay.co.nz/]] from the old WOProject site.
4
5 == Description ==
6
7 ##WOApplication## is an Ant task to build WebObjects applications from a set of files. It does not enforce any particular project structure and can be used to create applications without using the ProjectBuilder or XCode.
8
9 == Properties ==
10
11 WOApplication behavior depends on various properties in the wobuild.properties file that specify common locations of the frameworks used by the application. These properties can be initialized with the ant script woproperties.xml. Per default the woapplication task expects this file in $user.home/Library/wobuild.properties. If no file is found the woapplication task resolves the property WOBUILD//PROPERTIES from the java properties and the environment(in this order) to find the file.//
12
Ulrich Köster 45.1 13 |=Property from the wobuild.properties file|=Description|=Default
14 |wo.wosystemroot|Usually this is a WebObjects installation directory, like "C:pple".|NEXT//ROOT environment variable, or root directory "/".//
Andrew Lindesay 49.1 15 |wo.localroot|Usually this is a "Local" directory under the directory specified by "wo.woroot".|${{wo.woroot}}{{/wo.woroot}}/Local
16 |wo.homeroot|Usually this is a user home directory.|${{user.home}}{{/user.home}}
Paul Hoadley 17.1 17
18 == Parameters ==
19
Ulrich Köster 45.1 20 |=Attribute|=Description|=Required
21 |name|Name of the application (without .woa extension).|Yes
22 |chmod|Optional value for the chmod command executed by the WOApplication task. The default is "gu+x". The chmod command is only executed on the first build of the application and only on "Unix" platforms. The default is "750".|No
23 |destDir|Destination directory where the application woa should be created.|Yes
24 |wsDestDir|Destination directory where WebServerResorces should be copied during split install (presense of this parameter will trigger split install). WebServerResources will be created under [[wsDestDir]]/WebObjects/AppName.woa/Contents/.|No
25 |principalClass|Subclass of WOApplication to use.|Application
26 |customInfoPListContent|String to append to the Info.plist.|No
27 |stdFrameworks|If set to true, a set of standard frameworks will be associated with the deployed application (default is true). "Standard" frameworks are: JavaWebObjects, JavaWOExtensions, JavaEOAccess, JavaEOControl, JavaFoundation, JavaJDBCAdaptor, JavaXML.|No
28 |jvmOptions|String for the JVM options in the classpath.|No
29 |webXML|Generate web.xml|No
30 |webXML//WOROOT//|Optional parameter for the web.xml|No
31 |webXML//LOCALROOT//|Optional parameter for the web.xml|No
32 |webXML//WOAINSTALLROOT//|Optional parameter for the web.xml|No
33 |webXML//WOAppMode//|Optional parameter for the web.xml|No
34 |webXML//WOtaglib//|Optional parameter for the web.xml|No
35 |webXML//CustomContent//|Optional parameter for the web.xml|No
Paul Hoadley 17.1 36
37 == Nested Elements ==
38
39 === classes ===
40
Ulrich Köster 45.1 41 The nested ##classes## element specifies a [[FileSet>>http://jakarta.apache.org/ant/manual/CoreTypes/fileset.html]]. All files included in this fileset will end up in the ##Contents/Resources/Java/**.jar**##** file of the application.**
Paul Hoadley 17.1 42
43 === resources ===
44
Andrew Lindesay 49.1 45 The nested ##resources## element specifies a [[FileSet>>http://jakarta.apache.org/ant/manual/CoreTypes/fileset.html]]. All files included in this fileset will end up in the ##Contents/Resources## directory of the application. For the discussion of resource localization issues follow this link.