Building WOLips

Version 99.1 by Mike Schrag on 2005/09/23 16:15

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.