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

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 * 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
14
15 {{noformat}}
16
17 svn co http://wonder.svn.sourceforge.net/svnroot/wonder/trunk/Wonder WonderSource
18
19 {{/noformat}}
20
21 * As often as you prefer you can keep this up to date as follows:
22
23 {{noformat}}
24
25 cd /path/to/WonderSource
26 svn up
27
28 {{/noformat}}
29
30 == Build and Install Wonder ==
31
32 * Follow the "Building with Ant" instructions in the BUILD.txt document in the Wonder directory
33
34 {{warning title="WebObjects 5.4.X Compatability"}}
35
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:
37
38 ant \-Dwonder.patch=54 frameworks; sudo ant \-Dwonder.patch=54 frameworks.install
39
40 {{/warning}}
41
42 == Concepts ==
43
44 This complete procedure results in you having
45
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 ...