Skip to Content

Wiki source code of Getting the Wonder Source Code

Version 134.1 by David Avendasora on 2011/04/26 13:22
Show last authors
1 {{tip title="Now with more Git"}}
2
3 As of March 25th, 2011 the Wonder source code is now maintained on [GitHub|https://github.com/] at [https://github.com/projectwonder]. You'll need to be familiar with the [Git|http://git-scm.com/] Source Code Management system. [Here's|WO:Getting Started with Git] a good place to start. You will use Git to checkout a local copy of the repository (a "clone" in Git terms) allowing you to have direct access to the Wonder source.
4
5 {{/tip}}
6
7 == Why? ==
8
9 Instead of constantly re-downloading and installing the latest Wonder binaries you should work directly with the latest source code. It has several advantages including:
10
11 * You'll learn a lot about WebObjects, EOF and Object-Oriented Patterns
12 * Easily search, browse and even modify and improve Wonder
13 * Work with a specific revision, which is key for teams, quality control and development cycles
14 * Add logging statements in Wonder source so you can better understand what is going when tracking down hard to find bugs
15 * Discover the many Hidden Treasures of Wonder.
16
17 == Downloading ==
18
19 Open a terminal and navigate to a directory where you want to maintain a source "working copy" and just use the following commands to clone Wonder source to your computer.
20
21 1. h5. Clone the source repository from GitHub into a new directory named "WonderSource" or whatever you'd like.
22
23 {{note title="Read Only"}}
24 Note the URL shown here is the public read-only URL. Committers should use the SSH form of the URL for read-write
25 {{/note}}
26
27 {{code value="none"}}
28 git clone git://github.com/projectwonder/wonder.git WonderSource
29 {{/code}}
30
31 You should see output something like this:
32
33 {{noformat}}
34
35 Cloning into WonderSource...
36 remote: Counting objects: 174269, done.
37 remote: Compressing objects: 100% (57304/57304), done.
38 remote: Total 174269 (delta 107374), reused 173934 (delta 107067)
39 Receiving objects: 100% (174269/174269), 137.94 MiB | 8.29 MiB/s, done.
40 Resolving deltas: 100% (107374/107374), done.
41
42 {{/noformat}}
43
44 1. h5. Navigate into the working copy root
45
46 {{code value="none"}}
47 cd WonderSource
48 {{/code}}
49
50 {{note title="WebObjects 5.3.3 Compatability"}}
51 If you are still using old WebObjects 5.3.3, then you need to execute this git command to switch to the branch for WebObjects 5.3.3: {code}git checkout --track origin/Wonder_5_0_0_Legacy{code}
52 You should get output like this:
53 {noformat}
54 Branch Wonder_5_0_0_Legacy set up to track remote branch Wonder_5_0_0_Legacy from origin.
55 Switched to a new branch 'Wonder_5_0_0_Legacy'
56 {noformat}
57
58 {{/note}}
59
60 1. h5. Build and Install
61 For building and installing the Wonder Frameworks, please see the standard [[Building and Installing WO Frameworks with Ant>>WO:Building and Installing a WO Framework with Ant]] pages.
62
63 {{info}}
64
65 If you have any trouble or errors due to your local repository getting corrupted, simply delete the entire local repository (the {{\~/Roots}} directory) and start over using this source clone procedure.
66
67 {{/info}}