Version 212.1 by Kieran Kelleher on 2010/08/14 19:52

Hide last authors
Kieran Kelleher 136.1 1 == Introduction ==
David Avendasora 128.1 2
Kieran Kelleher 136.1 3 Instead of downloading the Wonder binaries, working from the latest source code directly can have some advantages such as:
miguel77mex 77.1 4
Kieran Kelleher 210.1 5 * Ability to browse the source code and learn from the wisdom and experience of the WO committers
6 * Put breakpoints in and step through Wonder source when debugging your projects
7 * Provide opportunities to submit patches to bugs you might find in Wonder
David Avendasora 112.1 8 * Add logging statements in Wonder source so you can better understand what is going when tracking down hard to find bugs
9
Kieran Kelleher 210.1 10 == Downloading Wonder Source from Subversion ==
David Avendasora 112.1 11
Kieran Kelleher 212.1 12 * Open a terminal shell and navigate to the directory where you want to maintain the WonderSource directory and decide on a name of the folder that will contain the Wonder source. For this example, we will use the name //WonderSource//
13 * Perform initial checkout of Wonder source tree from Subversion head using the following command. This checks out the source into the directory WonderLatest
Kieran Kelleher 186.1 14
Kieran Kelleher 210.1 15 {{noformat}}
Kieran Kelleher 186.1 16
Kieran Kelleher 212.1 17 svn co http://wonder.svn.sourceforge.net/svnroot/wonder/trunk/Wonder WonderSource
David Avendasora 128.1 18
Kieran Kelleher 210.1 19 {{/noformat}}
Kieran Kelleher 170.1 20
Kieran Kelleher 210.1 21 * As often as you prefer you can keep this up to date as follows:
Kieran Kelleher 196.1 22
Kieran Kelleher 210.1 23 {{noformat}}
Kieran Kelleher 170.1 24
Kieran Kelleher 212.1 25 cd /path/to/WonderSource
Kieran Kelleher 210.1 26 svn up
Kieran Kelleher 194.1 27
Kieran Kelleher 210.1 28 {{/noformat}}
Kieran Kelleher 194.1 29
Kieran Kelleher 210.1 30 == Build and Install Wonder ==
Kieran Kelleher 194.1 31
Kieran Kelleher 210.1 32 * Follow the "Building with Ant" instructions in the BUILD.txt document in the Wonder directory
Kieran Kelleher 194.1 33
Kieran Kelleher 210.1 34 {{warning title="WebObjects 5.4.X Compatability"}}
Kieran Kelleher 194.1 35
Kieran Kelleher 210.1 36 The default instructions in Wonder's BUILD.txt produce binaries that are compatable with WO 5.3.3. If you are using WO 5.4.X, then you need to add the "-Dwonder.patch=54" option to the ant commands. For example:
Kieran Kelleher 194.1 37
Kieran Kelleher 212.1 38 ant \-Dwonder.patch=54 frameworks; sudo ant \-Dwonder.patch=54 frameworks.install
Kieran Kelleher 194.1 39
Kieran Kelleher 210.1 40 {{/warning}}
Kieran Kelleher 194.1 41
Kieran Kelleher 210.1 42 == Concepts ==
Kieran Kelleher 170.1 43
Kieran Kelleher 212.1 44 This complete procedure results in you having
Kieran Kelleher 170.1 45
Kieran Kelleher 210.1 46 * a Wonder directory with the whole Wonder source tree (directories, projects, frameworks, example apps, miscellaneous, etc.) inside.
47 * The binary Wonder frameworks ("ant frameworks") will be installed in /Library/Frameworks.
48 * If you ran "ant applications", they will be installed in ...
49 * If you ran "ant examples", they will be installed in ...