This page describes how to build the IvyDE plugin from the source. The build is based on the Eclipse build system so it requires an Eclipse install. You also need to have an Ivy bundle installed. <h1><a name="setup"></a>Setup of the build</h1> <h2><a name="eclipse-install"></a>Eclipse installation</h2> You need first an Eclipse install which contains the PDE plugins (by default included in the "SDK" and "Classic" versions). We will refer to the eclipse installation path in the documentation as <tt>$ECLIPSE_HOME</tt>. In that <tt>$ECLIPSE_HOME</tt> folder you should have the plugins and features folders. It is <u>recommended</u> to have an eclipse installation dedicated to the build. So you will be able to have better control over the Ivy bundle installed there. And as the build clean the internal cache of Eclipse, running an eclipse and building with the same instance might raise some troubleshootings in the IDE. Lots of ant target depends on that Eclipse installation, so they need a <tt>baseLocation</tt> property to be defined. Note that you can avoid specifying that property in each command line by having a <tt>local.build.properties</tt> file which contains somethink like: <code> baseLocation=/home/me/tools/eclipse-3.4 </code> <h2><a name="install-ivy"></a>The Ivy bundle</h2> The IvyDE plugins depends on the Ivy 2.0 OSGi bundle. So the Ivy bundle have to be installed in the Eclipse installation before starting the build. An ant target will accomplished that task quite automatically. Inline help will be displayed when no property is specified: <code>ant install-ivy</code> <u>Note</u>: due to <a href="https://issues.apache.org/jira/browse/IVY-802">an old bug in the build script of Ivy</a>, the OSGi version of Ivy is "0.0.0" for every version older than the 2.0.0-RC1. So older version than 2.0.0-RC1 is not supported. <h1><a name="build"></a>Building</h1> First somehow you got some sources, for instance from the ASF subversion repository: <code> svn co https://svn.apache.org/repos/asf/ant/ivy/ivyde/trunk ivyde-trunk </code> or get directly the released sources from the <a href="../../download.cgi#sources">distribution</a>. And go into the root folder of the sources. In that folder you should see the builder, org.apache.ivyde.eclipse and org.apache.ivyde.feature folders. And run the build: <code>ant build -DbaseLocation=$ECLIPSE_HOME</code> Then in the created directory "work" you will find a directory (something like 2.0.0.alpha1-200804171513) in which you will find the zip archive ready to be unzipped in an Eclipse install. <h1><a name="install"></a>Install</h1> After a successful build you should have a zip file at <tt>dist/org.apache.ivyde.feature-$VERSION.zip</tt>. The zip file contains the "plugins" and "features" folders ready to be unzipped in an Eclipse install. So here is the process: <code> cd $ECLIPSE_HOME unzip ...../dist/org.apache.ivyde.feature-$VERSION.zip </code> Then start your Eclipse and enjoy !