Building WOLips

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 and install the following plugins and features:

1. EMF
2. GEF
3. JEM
4. WTP

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. 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. In CVS perspective, browse WOLips repository on HEAD, checkout woproject/projects as "projects"
4. Right-click (or equiv) on the build.xml inside of the "projects" project and Run As=>Ant Build ...
5. Switch to the Classpath tab and "Add Jar"
6. Browse to projects/lib and select jdom-b8.jar
7. Make sure the target is the default ("dist")
8. Run
9. 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.
10. 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.