Environment Setup

1. Install Java
2. Install Eclipse SDK
3. Install Apache Ant
4. Checkout and Configure uDig Build Scripts

Install Java

A 5.0 Java Runtime with the necessary extensions installed (JAI,SOAP,etc). See [Environment] for more details.

Install Eclipse SDK

The version of the eclipse SDK currently being used for uDig development with the necessary extensions installed (EMF,GEF,etc). See [Eclipse SDK Installation] for more details. This will be referred to as the host eclipse environment. It is used to compile and test uDig.

As well, the Eclipse Testing Framework must be installed as well. It can be obtained from the eclipse download site . There is a specific version of the framework for every eclipse build.

Install Apache Ant

Apache Ant (version >= 1.6.2). Ant can be obtained from http://download.eclipse.org/eclipse/downloads/index.php.

As well, the Subversion extension to Ant, svnant , must be installed as well. To install svnant perform the following steps.

1. Checkout the svnant source from http://svn.collab.net/repos/subclipse/trunk/svnant.
2. Change to root of source tree and execute ant build script.
3. Copy the following files to the lib directory of your ant installation.
   • build/lib/svnant.jar
   • lib/svnClientAdapter.jar
   • lib/svnjavahl.jar
   • lib/jakarta-regexp-1.3.jar
   • lib/commons-logging-1.0.4.jar

Checkout and Configure uDig Build Scripts

Checkout http://svn.geotools.org/udig/trunk/scripts to a directory of your choice. Inside the scripts directory is a build.properties file. The following properties must be edited to reflect your environment.

• baseLocation : The absolute path to your host eclipse enviroment.
• log.dir : Directory to copy build log to upon build.

Running the Build

To run the build, execute run.xml in the root of the scripts directory. In the event of an unsuccessful build, meaning that uDig failed to compile, the build.log file can sometimes help reveal problems. This file is automatically generated as part of the build process. It will not exist unless a build has been previously attempted.