Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

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:

http://webobjects.mdimension.com/wonder

Info
titleWhat Should I Download?

As you can see from this image, there are a number of different downloads. The 53 and 54 suffixes in this screen shot refer to binaries compiled for WebObjects 5.3.X and WebObjects 5.4.X compatibility respectively.

To start exploring Wonder and taking advantage of it in your applications, you just need to start with the "Wonder-latest-Frameworks". Choose the one suitable for your current version (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 aby of the other items shown here and explore as you wish.

Image Removed

Installation

  • Assuming you downloaded the latest Frameworks, simply double-click the tar.gz on Mac OS X to expand.
  • Expansion of the frameworks tar.gz should result in a directory of framework directories something like that shown below.
    Info
    titleContents 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
      titleFrameworks 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>
  • Installation is now complete and you may repeat this process anytime you want to update to the latest Wonder frameworks.

...

titleWIKITODO

...

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 (smile)

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.

Code Block
languagebash
titleProcedure for WebObjects 5.4.X
linenumberstrue

# 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
Code Block
languagebash
titleProcedure for WebObjects 5.3.X
linenumberstrue

# 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
Info
titleIf you have a custom environment layout

If you want to install the frameworks somewhere other than the default location, replace "/Library/Frameworks" on the last line above with the desired destination

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

Code Block
languagebash
titleProcedure for WebObjects 5.4.X
linenumberstrue

# 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
Code Block
languagebash
titleProcedure for WebObjects 5.3.X
linenumberstrue

# 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
Info
titleIf you have a custom environment layout

If you installed the frameworks somewhere other than the default location, replace "/Library/Frameworks" on the second and last lines above with the directory containing the installed frameworks.