Skip to Content
Last modified by David Avendasora on 2013/09/22 14:30
From version 34.1
edited by David Avendasora
on 2011/04/25 15:30
Change comment: There is no comment for this version
To version 36.1
edited by David Avendasora
on 2011/04/25 16:51
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Building
1 +Building a WebObjects Project
Content
... ... @@ -1,1 +1,53 @@
1 +== Overview ==
2 +
3 +There are two different and very distinct kinds of builds for a WebObjects project. Both make use of the ##woproject.jar## library that is embedded in WOLips to help Eclipse, Ant and Maven build a valid WebObjects Application (##.woa##) or WebObjects Framework (##.framework##) bundle.
4 +
5 +Both Incremental and Deployment builds make use of some common files to tell them where to look for resources needed to build an application or framework. They include:
6 +
7 +1. **build.properties**
8 +This file resides in the root directory your WebObjects project. It may be hidden from your view by Eclipse's ability to filter the displayed files in the //WO Explorer// view, but if you look in the project's directory in the finder/desktop/command line you will see it.
9 +1. **[[WOL:wolips.properties]]**
10 +This file can contain and override the same settings as the build.properties file, but it's primary purpose is to define the locations that a build done by Eclipse or Ant will look for compiled framework dependencies in. The default location of this file is:
11 +1*. **Mac OS X**: ##/Users/yourusername/Library/Application Support/WOLips/wolips.properties##
12 +1*. **Linux**: ##/home/<user>/Library/Application Support/WOLips/wolips.properties##
13 +1*. **Windows**: ##C:ocuments and Settingsuser>ibrarypplication SupportOLipsolips.properties##
14 +
15 +== Incremental Building ==
16 +
17 +=== ===
18 +
19 +While you are writing your classes and Components (.html, .wod, etc.) the incremental builder is running in the background continuously compiling and validating your code against your projects other code and dependencies. You can launch your applications from within WOLips/Eclipse with no need to manually compile or install any source code either from your current project, or from any frameworks in the workspace that your project depends upon. WOLips/Eclipse takes care of resolving dependencies for things that are not in the locations they will be in in a deployed ##.woa## or ##.framework## bundle. The Incremental Builder does not use Ant or Maven. Just because your project runs fine in Eclipse/WOLips does not necessarily mean it will build, let alone run, when using Ant or Maven.
20 +
21 +== Deployment Building ==
22 +
23 +=== ===
24 +
25 +The process of building WebObjects Applications and Frameworks for Deployment is more complicated and requires any depended-upon frameworks to already be compiled and installed in defined (but customizable) locations. Building and Installing of both Frameworks and Applications can be also be done directly in Eclipse, but it can also be done from the Command Line or better yet, using a Continuous Integration Server like Hudson/Jenkins. Use of Hudson/Jenkins to build your Applications is **highly** recommended.
26 +
27 +The process and options vary slightly between Frameworks and Applications, but they share many fundamental concepts.
28 +
29 +1. build.properties file
30 +
31 +{{code title="Example Application build.properties File"}}
32 +
33 +classes.dir=bin
34 +component.inlineBindingPrefix=$
35 +component.inlineBindingSuffix=
36 +component.wellFormedTemplateRequired=false
37 +customInfoPListContent=
38 +embed.Local=true
39 +embed.Project=true
40 +embed.System=true
41 +eoAdaptorClassName=
42 +principalClass=com.company.MyApp.Application.java
43 +project.name=MyApp
44 +project.name.lowercase=myapp
45 +project.type=application
46 +webXML=false
47 +webXML_CustomContent=
48 +
49 +{{/code}}
50 +
51 +1. wolips.properties file
52 +
1 1  {{pagetree root="@self"}}{{/pagetree}}