Building WOLips

Version 97.1 by Mike Schrag on 2005/09/15 17:51

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, currently 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:

Downloading the Nightly Build

If you don't want to build WOLips yourself, but you'd like to use the latest and greatest version, you can install the nightly build from http://www.mdimension.com/~wolips/update/ by:

  1. Help=>Software Updates=>Find and Install ...
  2. Search for new features to install, select Next >
  3. Select New Remote Site ...
  4. Name = mDimension WOLips Nightly Build, URL = http://www.mdimension.com/~wolips/update/ , select OK
  5. Select the newly added site, select Finish >
  6. Follow the rest of the instructions, selecting all of the "Yes" responses

Checking out and Building from the Commandline

  1. cvs d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/woproject login
    1. username = anonymous
    2. no password
  2. cvs d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/woproject co woproject
  3. cd woproject/projects
  4. ant
  5. The first build will fail out telling you that it couldn't find wobuild.properties -- That's OK
  6. Edit /Library/wobuild.properties
  7. Add a line eclipse.home=/path/to/your/eclipse
  8. ant again and it should succeed this time
    1. If you get the error 'build.xml:73: taskdef A class needed by class org.apache.velocity.anakia.AnakiaTask cannot be found: org/jdom/JDOMException', you can do one of two things.  You can build with Dno.docs=true to skip the javadoc step, or (untested) you can drop jdomb8.jar from woproject/projects/lib into your ANTHOME/lib folder.
  9. The build went into temp/dist
  10. Profit
  11. Installing WOLips

Checking out and Building inside of Eclipse for Deployment

  1. Add the wolips CVS repository
    1. host = cvs.sourceforge.net
    2. root = /cvsroot/woproject
    3. protocol = pserver
    4. login = anonymous
    5. no password
  2. In CVS perspective, browse WOLips repository on HEAD, checkout woproject/projects as "projects"
  3. Right-click (or equiv) on the build.xml inside of the "projects" project and Run As=>Ant Build ...
  4. Switch to the Classpath tab and "Add Jar"
  5. Browse to projects/lib and select jdom-b8.jar
  6. Make sure the target is the default ("dist")
  7. Run
  8. Once it is complete, you will have to right-click=>refresh the "projects" project and you will have a temp/dist folders with the plugin site in it.
  9. Installing WOLips

Checking out and Building inside of Eclipse for Development (PDE)

  1. install jmechanic plugin from The JMechanic Site
    1. just untar this into your plugins folder
  2. Add the wolips CVS repository
    1. host = cvs.sourceforge.net
    2. root = /cvsroot/woproject
    3. protocol = pserver
    4. login = anonymous
    5. no password
  3. From the Java perspective, Import=>Team Project Set and select wolips.psf (see below)
  4. This will cause a really long checkout and you'll have a TON of build errors ... Don't fret.
  5. Copy projects/lib/cayenne-1.1RC3-dev.jar to org.objectstyle.wolips.cayenne/lib/cayenne.jar and refresh the org.objectstyle.wolips.cayenne project
  6. Add a classpath variable ANTHOME that points to eclipse/plugins/org.apache.ant1.6.5 (Preferences=>Java=>Build Path=>Classpath Variables, New... name ANTHOME, Folder... =>youreclipsehome/plugins/org.apache.ant1.6.5)
  7. make projects/temp, projects/temp/classes, and projects/temp/doc folders
  8. run projects/build.xml as "Ant Build ...", select the "woenvironment" and "woproject" targets and select Order... and move woenvironment above woproject in the order, Build
  9. copy projects/temp/build/woproject$build.version/lib/woproject.jar to org.objectstyle.wolips.woproject/lib and refresh the org.objectstyle.wolips.woproject

You should end up with no source or build path errors.