Getting the Wonder Source Code

Why?

Instead of constantly re-downloading and installing the latest Project Wonder binaries you should work directly with the latest source code. It has several advantages including:

• You'll learn a lot about WebObjects, EOF and Object-Oriented Patterns
• Easily search and browse Project Wonder
• Work with a specific revision of Project Wonder, which is key for teams, quality control and development cycles
• Add logging statements to Project Wonder so you can better understand what it is doing when tracking down hard to find bugs
• Discover the Many Hidden Treasures of Wonder™.

Download It!

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.

1. Clone the source repository from GitHub into a new directory named "WonderSource" or whatever you'd like.

   git clone git://github.com/wocommunity/wonder.git WonderSource

   If "git://" does not work for you then use "http://"

   Error

   There is no valid license for Pro Macros. Please visit the Licenses section.

   You should see output something like this:

   Unknown macro: noformat. Click on this message for details.

   The [noformat] macro is not in the list of registered macros. Verify the spelling or contact your administrator.

2. Navigate into the working copy root

   cd WonderSource

   Error

   There is no valid license for Pro Macros. Please visit the Licenses section.

Use It!

• Use Wonder source code projects in your Eclipse workspace

  The best way to make use of Project Wonder is obviously to import the source code projects directly into your Eclipse workspace. Why would you be reading this page if that isn't what you are trying to do?! Detailed instructions are here: Working with Wonder source in Eclipse

  Error

  There is no valid license for Pro Macros. Please visit the Licenses section.

• Build and Install Project Wonder Binary Frameworks

  For building and installing the Wonder Frameworks, please see the standard Building and Installing WO Frameworks with Ant pages.

  Error

  There is no valid license for Pro Macros. Please visit the Licenses section.

• Build Project Wonder frameworks with Hudson/Jenkins

  The ideal way to build WebObjects frameworks and applications is to use a "Continuous Integration Server" or "Build Server" like Hudson or Jenkins. This allows you to automate the often complex process of building WebObjects projects that have several dependencies on frameworks. Instructions on how to setup a Hudson/Jenkins server is are available on the Installing and Configuring Jenkins page.