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
- Go to http://github.com/bixo/bixo/downloads
- Click on the desired bixo-dist-<version>.tgz link.
- Expand the file into a directory on your computer.
Getting the latest source from GitHub via downloads
- Go to http://github.com/bixo/bixo/archives/master
- Click the “Download .tar.gz” or “Download .zip” button.
- Expand the file into a directory on your computer.
Getting the latest source from GitHub via git
- If you are new to git, then the Bixo wiki has some useful information to get you started
- Make sure you have a working git command line client installed
-
% cd <parent directory>
-
% 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:
-
% cd <project root>
-
% ant eclipse
- From Eclipse, follow standard procedure to import an existing Java project into your Workspace.
Advertisements