HOWTO Building Azureus from source package with Ant
From WikiTechia
This guide will go through the process of building azureus from source package using ant. If it is foreseeable that development on Azureus may get returned to the codebase, then it is highly recommended that it is sourced via CVS as opposed to a source package.
Contents |
Ant and JAVA
Ant is a JAVA and XML based cross-platform build utility. This as well as JAVA JDK needs to be installed on the build system. If windows is being used, WikiTechia has a guide on how to set that up.
Getting the source
First, the azureus source is required, which can be found in Azureus' main downloads section after clicking Jar, Jar torrent, Source
- Download Azureus Source
Getting libs
For some reason libs needed to build Azureus are not included in the source package. The libs that are in JAR format can only be download from the Azurues CVS repository, which is thankfully available via a web interface.
All files from that directory are required, at time of writing, they included
- apple-extensions.jar
- commons-cli.jar
- junit.jar
- log4j.jar
- swt-osx.jar
- swt-win32.jar
Building
- Extract the azureus source to a directory.
- Make new directories in the azureus source directory, build\libs, and copy the libs into that directory.
- From a command prompt in the azureus directory, run ant
- A newly built Azureus2.jar will have then been created in the dist directory. This needs to be copied this over an existing Azurues install.
JAVA OutOfMemoryError
During the build of azureus it will probably fail with an error related to java running out of memory. To remedy this, java needs to be assigned more memory in the commannd line by setting up the ANT_OPTS variable.
Type into the command line before running ant to build azureus.
set ANT_OPTS="-Xmx128m"
This instructs ant to use 128mb of memory when calling java.
ANT_OPTS can also be set as a system environment variable like what was done for ANT_HOME and JAVA_HOME.
