Version 210.1 by Kieran Kelleher on 2010/01/11 12:30

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 210.1 12 * Decide on a directory where you will maintain the latest Wonder source tree on your hard drive. I have a directory ',,/WonderLatest' in my home folder.,,
13 * Open a terminal shell and navigate to the directory
Kieran Kelleher 186.1 14
Kieran Kelleher 210.1 15 {{noformat}}
Kieran Kelleher 186.1 16
Kieran Kelleher 210.1 17 mkdir ~/WonderLatest
David Avendasora 128.1 18
Kieran Kelleher 210.1 19 {{/noformat}}
Kieran Kelleher 170.1 20
Kieran Kelleher 210.1 21 * Next perform initial checkout of Wonder source tree from Subversion head using the following command. This creates a folder named Wonder
Kieran Kelleher 196.1 22
Kieran Kelleher 210.1 23 {{noformat}}
Kieran Kelleher 196.1 24
Kieran Kelleher 210.1 25 svn co https://wonder.svn.sourceforge.net/svnroot/wonder/trunk/Wonder ~/WonderLatest
Kieran Kelleher 196.1 26
Kieran Kelleher 210.1 27 {{/noformat}}
Kieran Kelleher 196.1 28
Kieran Kelleher 210.1 29 * As often as you prefer you can keep this up to date as follows:
Kieran Kelleher 196.1 30
Kieran Kelleher 210.1 31 {{noformat}}
Kieran Kelleher 170.1 32
Kieran Kelleher 210.1 33 cd ~/WonderLatest
34 svn up
Kieran Kelleher 194.1 35
Kieran Kelleher 210.1 36 {{/noformat}}
Kieran Kelleher 194.1 37
Kieran Kelleher 210.1 38 == Build and Install Wonder ==
Kieran Kelleher 194.1 39
Kieran Kelleher 210.1 40 * Follow the "Building with Ant" instructions in the BUILD.txt document in the Wonder directory
Kieran Kelleher 194.1 41
Kieran Kelleher 210.1 42 {{warning title="WebObjects 5.4.X Compatability"}}
Kieran Kelleher 194.1 43
Kieran Kelleher 210.1 44 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 45
Kieran Kelleher 210.1 46 ant -Dwonder.patch=54 frameworks; sudo ant -Dwonder.patch=54 frameworks.install
Kieran Kelleher 194.1 47
Kieran Kelleher 210.1 48 {{/warning}}
Kieran Kelleher 194.1 49
Kieran Kelleher 210.1 50 == Concepts ==
Kieran Kelleher 170.1 51
Kieran Kelleher 210.1 52 This complete procedure results in you having
Kieran Kelleher 170.1 53
Kieran Kelleher 210.1 54 * a Wonder directory with the whole Wonder source tree (directories, projects, frameworks, example apps, miscellaneous, etc.) inside.
55 * The binary Wonder frameworks ("ant frameworks") will be installed in /Library/Frameworks.
56 * If you ran "ant applications", they will be installed in ...
57 * If you ran "ant examples", they will be installed in ...