Page History

Introduction

If you are just starting out with Wonder, the simplest path to usage is probably to download the binaries and install the frameworks. Mike Schrag and the good folks at mDimension Technology provide a binary download that is automatically updated daily from the latest Wonder source. So freshness is guaranteed.

Download

You can get the latest binaries here:

WebObjects 5.3.x: http://webobjects.mdimension.com/hudson/job/Wonder53/lastStableBuild/artifact/dist/
WebObjects 5.4.x: http://webobjects.mdimension.com/hudson/job/Wonder54/lastStableBuild/artifact/dist/

There are a number of different downloads. To start exploring Wonder and taking advantage of it in your applications, you just need to start with the "Wonder-Frameworks.tar.gz" for your current version of WO (OS X Tiger has WO 5.3.X by default and OS X Leopard has 5.4.X by default). Of course you can download any of the other items shown here and explore as you wish.

Installation

• Assuming you downloaded the latest Frameworks, simply double-click the tar.gz on Mac OS X to expand.

  Warning
  Please note that if you decompress the file by command-line, the frameworks will be extracted in the working directory.  You should create a new directory (for example: wonder-latest) and extract the files in this directory

• Expansion of the frameworks tar.gz should result in a directory of framework directories something like that shown below.

  Info
  title Contents of the Latest Frameworks tar.gz archive
  Image Removed

• Next, open Terminal.app
• Navigate into the directory you just expanded that contains all the frameworks
  • $ cd some/dir/latest-frameworks

    Info
    title Frameworks Listing in Terminal.app
    Image Removed

• Next copy the frameworks to /Library/Frameworks using the following command:
  • $ sudo cp -Rf *.framework /Library/Frameworks/

• Alternative options that may work for you:
  • OR, you can just drag the expanded frameworks folders into the /Library/Frameworks folder using Finder, overwriting any previous version of the frameworks you have in there. You may have to be logged in as an Admin user.
  • OR (more advanced), you can do it all in one step: in terminal <cd /Library/Frameworks> then expand the frameworks into the /Library/Frameworks directory with this command <sudo tar xvfz some/dir/latest-frameworks.tar.gz>

...

...

The most recent binary build of Wonder frameworks for both WO 5.3.3 and WO 5.4.3 are available from jenkins.wocommunity.org. This installation method gets you the latest version.

However, if you are not afraid of source (and you shouldn't be!), then try the Source installation and upgrade article instead. Really, working with Wonder source is the recommended way, and you will learn more and be a better WebObjects developer as a result

Overview

The objective is to simply download the compressed archive of the Wonder frameeworks, expand the archive and copy the frameworks to the default frameworks location.

New Installation Procedure

Open a terminal session and type the following easy commands. Choose the one for your WebObjects version.

# Make a directory for the binaries
mkdir ~/WonderBinaries54

# Go into the directory
cd ~/WonderBinaries54

# Download the binaries archive
curl -L -O http://jenkins.wocommunity.org/job/Wonder/lastSuccessfulBuild/artifact/Root/Roots/Wonder-Frameworks.tar.gz

# Decompress the archive
tar -xzvf Wonder-Frameworks.tar.gz

# Copy the frameworks to the default runtime path
sudo cp -Rvf *.framework /Library/Frameworks

# Make a directory for the binaries
mkdir ~/WonderBinaries53

# Go into the directory
cd ~/WonderBinaries53

# Download the binaries archive
curl -L -O http://jenkins.wocommunity.org/job/WonderLegacy/lastSuccessfulBuild/artifact/Root/Roots/Wonder-Frameworks.tar.gz

# Decompress the archive
tar -xzvf Wonder-Frameworks.tar.gz

# Copy the frameworks to the default runtime path
sudo cp -Rvf *.framework /Library/Frameworks

Upgrade Existing Installation Procedure

You can just download and copy using the finder, or use the command line as follows to cleanly remove the old installation and install a fresh latest binaries upgrade.

Assuming you have the same working directory as above whn you did a new installation

# Navigate to the directory where you previously expanded the original binaries
cd ~/WonderBinaries54

# Delete the installed binary frameworks whose names match the nams of the frameworks in this working directory
for FRAMEWORK in `echo *.framework`; do sudo rm -r /Library/Frameworks/${FRAMEWORK}; done

# Delete the contents of this working directory
rm -r *

# Download latest binaries archive
curl -L -O http://jenkins.wocommunity.org/job/Wonder/lastSuccessfulBuild/artifact/Root/Roots/Wonder-Frameworks.tar.gz

# Expand the archive
tar -xzvf Wonder-Frameworks.tar.gz

# Install the frameworks
sudo cp -Rvf *.framework /Library/Frameworks

# Navigate to the directory where you previously expanded the original binaries
cd ~/WonderBinaries53

# Delete the installed binary frameworks whose names match the nams of the frameworks in this working directory
for FRAMEWORK in `echo *.framework`; do sudo rm -r /Library/Frameworks/${FRAMEWORK}; done

# Delete the contents of this working directory
rm -r *

# Download latest binaries archive
curl -L -O http://jenkins.wocommunity.org/job/WonderLegacy/lastSuccessfulBuild/artifact/Root/Roots/Wonder-Frameworks.tar.gz

# Expand the archive
tar -xzvf Wonder-Frameworks.tar.gz

# Install the frameworks
sudo cp -Rvf *.framework /Library/Frameworks