Project Wonder Installation on Windows

This page is designed to be a ground floor installation procedure for installing Project Wonder, including: Eclipse, WebObjects and the WOlips plugin.  This guide assumes Windows 7 (procedure should be the same for Windows XP and Vista).

There are four sections to this installation process.

Step 1: Install a JDK 1.6

Before installing anything else, you need to install a JDK. We suggest that you install the official JDK 1.6 from Oracle. Don't install a JRE, the tools really need the JDK.

Step 2:  Install the latest version of Eclipse

Head over to the Eclipse Foundation and download the latest version of Eclipse 3.7 suitable for your Windows version.  We suggest the "Classic" bundle of Eclipse.

Eclipse does not install as a package, rather it is simply a compressed archive.  Installation is as simple as extracting the Eclipse folder, entering it and running the Eclipse executable.  In this context, it is important to remember where the folder resides on your system for future use.

Step 3:  Install WOlips plugin and the WebObjects Framework

1. h5. Install WOLips Plugin

Currently you have a stock Eclipse installation which will allow you to do normal Java development, but it does not contain any of the WOLips plugins, so you will not have any of the WebObjects development tools. To begin your WOLips installation, from within Eclipse, select Help => Install New Software...

This opens the "Install" panel where you can specify sites for Eclipse to download new software features. This dialog allows you to add/inspect any software features you have downloaded or were included in your default install of Eclipse. You can click "Available Software Sites" to see what was included by default.

1. 
   
   1. To install WOLips you will need to add the WOLips update site to Eclipse. You do this by clicking the "Add" button.  In the Name field you can enter a name for your update site. The name is arbitrary but since you could have multiple similar update sites you should give it a name that leaves no doubt about what it is.
      
      In the Location field, enter one of the following URLs:
      • Stable: (For Eclipse 3.6) http://webobjects.mdimension.com/hudson/job/WOLips36Stable/lastSuccessfulBuild/artifact/site/
      • Current: (For Elipse 3.7) http://webobjects.mdimension.com/hudson/job/WOLips37Current/lastSuccessfulBuild/artifact/site/
   2. You are returned to the "Install" panel, the WOLips site having been added to the list, and fully expanded to display all its offerings. Select features you want. If you're just getting started with WOLips you should select "WOLips" and "WOLips Goodies." Leave the other options until you are more familiar with Eclipse and WOLips and decide that you need them. (Here are some WO:Other WOLips Install Options.)  After selecting the options you want, click "Next." You'll briefly see a progress bar while Eclipse "calculates requirements and dependencies."
      
   3. You'll see an "Install" panel, asking you to Review and Confirm selected items to be installed.
      
   4. Click Next >. The next dialog contains the license agreements for the selected features. After reviewing the agreements (you DO review your license agreements, right :-) &nbsp, select "I accept the terms of the license agreement." Selecting this radio button will accept the license agreements for all of the features listed. Click Finish to continue. You may also get a warning about "unsigned content." Click "OK" to dismiss that dialog and continue the install.
      
   5. Eclipse will now download and install all the selected features and plugins. When it has completed, it will prompt you to restart Eclipse. Select "Restart Now."
      

2.  Install the WebObjects Framework

Once the WOlips plugin is installed, you will need to install the core frameworks with the help of WOInstaller.jar, available from the wocommunity.org site. After, open a Command Prompt, and enter the following command:

You might get an error about a missing folder in C:ppleibrary, you can ignore this error.

Step 4:  Link the Framework to WOlips through the properties configuration file

This is the most intricate step in the installation process.  The configuration file found in the WOlips preferences must correctly reference the framework directory structure.  Failure to successfully complete this step will result in broken libraries.

Running the script from step 2 installs the WO framework to the /Developer/WebObjects543 directory on your system. Below is the contents for a configuration file that matches this setup.  Create a new file called wolips.543.properties.  Copy the code below (after modification) into that file.

Place this file in /Library/Application Support/WOLips, this directory should already exist and contain the default wolips.properties file.

The second part of this step is to link the WOlips plugin with the WO framework installed on your system.  This is done through the tab found at Eclipse menu > Preferences > WOlips.

Change the "WOlips Properties File" to wolips.543.properties and click OK. 

At this point, you should have a functioning WebObjects platform to work with, visit <hello world link> to test your first WebObjects application.

{+}Video of Step 3:+

Step 5: &nbsp;Import Project Wonder into your Eclipse workspace

&nbsp;Please follow this guide: &nbsp;Getting the Wonder Source Code, which includes the page for importing the Project Wonder source&nbsp;into your Eclipse workspace.

{+}Video of Step 4:+

At the end of this step, you will have Project Wonder imported into Eclipse under its own working set. &nbsp;If you are unfamiliar with working sets in Eclipse, the following video will help clarify. &nbsp;This video also demonstrates a "Hello World" project creation to validate proper installation.

&nbsp;&nbsp;