Last modified by Bastian Triller on 2013/10/05 10:40

From version 136.1
edited by Kieran Kelleher
on 2007/12/12 09:17
Change comment: There is no comment for this version
To version 135.1
edited by David Avendasora
on 2011/04/26 13:22
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Download Wonder Source, Build and Install
1 +Getting the Wonder Source Code
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.kieran
1 +XWiki.avendasora
Content
... ... @@ -1,40 +1,67 @@
1 -== Introduction ==
1 +{{tip title="Now with more Git"}}
2 2  
3 -Instead of downloading the Wonder binaries, working from the latest source code directly can have some advantages such as:
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 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
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
8 8  * 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.
9 9  
10 -== Downloading Wonder Source from CVS ==
17 +== Downloading ==
11 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
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.
14 14  
15 -{{noformat}}
21 +1. h5. Clone the source repository from GitHub into a new directory named "WonderSource" or whatever you'd like.
16 16  
17 -cd ~/WonderLatest
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}}
18 18  
19 -{{/noformat}}
27 +{{code value="none"}}
28 +git clone git://github.com/projectwonder/wonder.git WonderSource
29 +{{/code}}
20 20  
21 -* Next perform initial checkout of Wonder source tree from CVS head using the following command. This creates a folder named Wonder
31 +You should see output something like this:
22 22  
23 23  {{noformat}}
24 24  
25 -cvs -z3 -d:pserver:anonymous@wonder.cvs.sourceforge.net:/cvsroot/wonder co -P Wonder
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.
26 26  
27 27  {{/noformat}}
28 28  
29 -== Build and Install Wonder ==
44 +1. h5. Navigate into the working copy root
30 30  
31 -* Follow the "Building with Ant" instructions in the BUILD.txt document in the Wonder directory
46 +{{code value="none"}}
47 +cd WonderSource
48 +{{/code}}
32 32  
33 -== Concepts ==
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}
34 34  
35 -This complete procedure results in you having
58 +{{/note}}
36 36  
37 -* a Wonder directory with the whole Wonder source tree (directories, projects, frameworks, example apps, miscellaneous, etc.) inside.
38 -* The binary Wonder frameworks ("ant frameworks") will be installed in /Library/Frameworks.
39 -* If you ran "ant applications", they will be installed in ...
40 -* If you ran "ant examples", they will be installed in ...
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}}