Building Bixo

Requirements

• a Java Development Kit (JDK) – Java version 6 or later.
• the ant command line tool – version 1.7 or later.
• the git command line tool  if you want to get the latest source from GitHub.

Getting release sources

1. Go to http://github.com/bixo/bixo/downloads
2. Click on the desired bixo-dist-<version>.tgz link.
3. Expand the file into a directory on your computer.

Getting the latest source from GitHub via downloads

1. Go to http://github.com/bixo/bixo/archives/master
2. Click the “Download .tar.gz” or “Download .zip” button.
3. Expand the file into a directory on your computer.

Getting the latest source from GitHub via git

1. If you are new to git, then the Bixo wiki has some useful information to get you started
2. Make sure you have a working git command line client installed

3. % cd <parent directory>

4. % git clone git://github.com/bixo/bixo.git bixo

This will create a directory called bixo in your <parent directory>

Building Bixo

Once you have the source, and a working ant command line tool installed, then you can use the following commands from inside of the bixo directory:

• ant -p (list available build targets)
• ant clean test (clear out build directories, compile, run tests)
• ant jar (build the bixo-core-<version>.jar files)
• ant dist (build a distribution jar, for releases)

WARNING: Due to an apparent bug in the Maven ant task plug used by Bixo, you cannot currently run “ant clean test jar”. If you try this, you’ll get a “java.lang.ClassCastException”. The solution is to run just “ant clean jar” which automatically runs test.

Working in Eclipse

To create an Eclipse project:

1. % cd <project root>

2. % ant eclipse

3. From Eclipse, follow standard procedure to import an existing Java project into your Workspace.