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

Show last authors
1 == Introduction ==
2
3 Instead of downloading the Wonder binaries, working from the latest source code directly can have some advantages such as:
4
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
8 * Add logging statements in Wonder source so you can better understand what is going when tracking down hard to find bugs
9
10 == Downloading Wonder Source from Subversion ==
11
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
14
15 {{noformat}}
16
17 mkdir ~/WonderLatest
18
19 {{/noformat}}
20
21 * Next perform initial checkout of Wonder source tree from Subversion head using the following command. This creates a folder named Wonder
22
23 {{noformat}}
24
25 svn co https://wonder.svn.sourceforge.net/svnroot/wonder/trunk/Wonder ~/WonderLatest
26
27 {{/noformat}}
28
29 * As often as you prefer you can keep this up to date as follows:
30
31 {{noformat}}
32
33 cd ~/WonderLatest
34 svn up
35
36 {{/noformat}}
37
38 == Build and Install Wonder ==
39
40 * Follow the "Building with Ant" instructions in the BUILD.txt document in the Wonder directory
41
42 {{warning title="WebObjects 5.4.X Compatability"}}
43
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:
45
46 ant -Dwonder.patch=54 frameworks; sudo ant -Dwonder.patch=54 frameworks.install
47
48 {{/warning}}
49
50 == Concepts ==
51
52 This complete procedure results in you having
53
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 ...