Skip to Content
Version 192.1 by tmk on 2010/09/10 02: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 conveniently browse and search 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 * Work with specific versions of Wonder in a project - good practice for quality control, especially for teams
10
11 == Downloading Wonder Source from Subversion ==
12
13 * 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//
14 * Perform initial checkout of Wonder source tree from Subversion head using the following command. This checks out the source into the directory //WonderSource//, automatically creating //WonderSource// if it does not exist.
15
16 {{noformat}}
17
18 svn co http://wonder.svn.sourceforge.net/svnroot/wonder/trunk/Wonder WonderSource
19
20 {{/noformat}}
21
22 * As often as you prefer you can keep this up to date as follows:
23
24 {{noformat}}
25
26 cd /path/to/WonderSource
27 svn up
28
29 {{/noformat}}
30
31 == Build and Install Wonder ==
32
33 * Follow the "Building with Ant" instructions in the BUILD.txt document in the Wonder directory
34
35 {{warning title="WebObjects 5.4.X Compatability"}}
36
37 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:
38
39 ant \-Dwonder.patch=54 frameworks; sudo ant \-Dwonder.patch=54 frameworks.install
40
41 Alternatively, to avoid having to type the \-Dwonder.patch=54 option every time, one can put the line "wonder.patch=54" either in the wolips.properties file that resides in the \~/Library/Application Support/WOLips directory or in a build.properties file in the Wonder source root directory.
42
43 {{/warning}}
44
45 == Concepts ==
46
47 This complete procedure results in you having
48
49 * a Wonder directory with the whole Wonder source tree (directories, projects, frameworks, example apps, miscellaneous, etc.) inside.
50 * The binary Wonder frameworks ("ant frameworks") will be installed in /Library/Frameworks.
51 * If you ran "ant applications", they will be installed in ...
52 * If you ran "ant examples", they will be installed in ...