Installing WOLips

Version 104.1 by Mike Schrag on 2005/09/24 20:06

You have three options for installing WOLips.

The first is to grab the latest stable build from the WOLips/WOProject Site.  You can then just install it liike any other Eclipse plugin.  However, you are getting a version of the code that is pretty old now.

The second way is to grab one of the Nightly Builds.  Nightly builds are built from the latest-and-greatest source at the head of the CVS tree.

Lastly you can instead build WOLips yourself and enjoy the latest and greatest features and bugfixes.  This is basically the same as the nightly builds, but do-it-yourself.

WOLips Dependencies

Recent version of WOLips in CVS have more extensive dependencies than prior builds (mostly due to the HTML editor that is part of the web tools project).

Additionally you will need to download and install Eclipse 3.1.1, a build of Eclipse that does not currently have an official release.

You can get a 3.1.1 build from Eclipse.org.

After installing Eclipse 3.1.1 and before building or installing WOLips, you will need to download, unzip the following plugins and features, and copy the corresponding plugins and features into your eclipse plugins and features folders:

A mirror of these dependencies is maintained in various prepackaged forms at the Nightly Build site (see below), so you don't have to get it from the "official source" if you don't want.

WOLips Nightly Build Server

Nightly builds of WOLips are maintained in several forms at http://www.mdimension.com/~wolips/.  Among the various packagings you will find are:

  • http://www.mdimension.com/~wolips/dependencies/
    This folder contains all the zips for the dependencies of wolips (so you don't have to go through all those damn sites)
  • http://www.mdimension.com/~wolips/wolips-latest.tar.gz
    This is a .tar.gz of the features and plugins folders if you don't want to use eclipse updating to install.  This is rebuilt nightly, but i was too lazy to pull the version # to put it in the filename emoticon_smile
  • http://www.mdimension.com/~wolips/wolips-all-latest.tar.gz
    This is a single tar.gz with all of the dependencies uncompressed and the latest wolips that you can unzip over top of your eclipse folder ... so if you want to do an initial install, just grab this.  Same laziness on version # in filename -- it's rebuilt along w/ the nightly build.

Installing the Nightly Build

Prior to installing a nightly build, you must have all dependencies installed.  Nightly builds do not currently package and deploy the dependencies. The nightly build of WOLips can be installed following the steps in the Install WOLips with Eclipse Update Manager tutorial.

Installing from a Local Build

  1. If you made changes locally, Eclipse will not automatically install your changed plugins if the version number is the same.  You have two options -- either uninstall WOLips or cheat and increment the WOLips build version prior to building your local copy.  To uninstall WOLips, just delete all org.objectstyle features and plugins from your eclipse folder.  To increment the build server version, open buildserver.version in your projects folder and increment the last number.  Note that you will now be "competing" with version numbers from the official build server, so the next official build will not install because you already used the next number, but sometimes it's a quick hack to force an update if you're lazy emoticon_smile
  2. Assuming you now have your build versions under control, you should follow the instructions for Building WOLips 
  3. Launch Eclipse
  4. Help=>Software Updates=>Find and install ...
  5. Search for new features to install
  6. New Local Site
  7. Browse to and select your workspace/projects/temp/dist folder or your woproject/projects/temp/dist folder (depending on whether you checked out in eclipse or commandline)
  8. Check the box next to it, continue, and just keep selecting the "Yes"/"OK"/"Approve"/etc buttons