Development Environment
The simplest installation involves MS Visual C++ 6.0, Eclipse 3.1 and JDK 1.4.
In that situation, you would just create the compilation_tools.properties
using the example build.xml as a template. All of the releases, up through 1.11,
were built using Visual C++ 6.0.
- Microsoft Visual C++ 6.0 and it's included library. (to D:\apps in my case)
- Eclipse 3.1 or later from www.eclipse.org.
- Java JDK 1.4 (this was built using 1.4.2.09)
Compilation using JDK 1.5 has not been tested
Build Process
The build process is based on ANT. It cannot be built using MAKE.
You can run ANT from inside of eclipse or from the command line.
The ant process is driven off of a configuration file named
compilation_tools.properties that describes the locations of the JDK and Microsoft
C++ tools. The build.xml file in the root directory contains examples of the contents
of this file.
There are two main ant targets.
- "default" executes the following steps when using the default target.
- Build the Java code
- Build the jni code
- create the dll
- create jar file
- "package" runs the above listed steps and then
- builds the javadoc
- builds a source zip
- builds a binary zip with the javadoc
Eclipse Java IDE
Eclipse users have to do some minor tweaks to their project if they
want to use the integrated build process. This is because the unit
tests are files located in the "unittest" directory while
the project source files themselves are in "src" the root directory.
By default, eclipse will add the entire project as source. This
messes up the package naming. A couple small tweaks to the build path
fix this problem.
- Eclipse automatically adds the whole project as a source directory
- Remove the root of the project from the build path
- Add folders samples, src and unittest to the build path
- Exclude *.txt from each of the newly added folders.
Repository Organization
Unpack the source archive zip file or check the files out of CVS into d:\jacob
or some other familiar place. Source Java and JNI files are located in seperate
packages from the unit tests and the samples.
The java code is in .\src.
The C++ code is in .\jni.
The Servlet examples that required j2ee libraries to compile have temporarily
been removed.
64 bit build support
64 bit builds are not supported at this time
A 64 bit build would involve:
- Microsoft Visual C++ 6.0 and it's included library. (installed in D:\apps in my case)
- Microsoft SDK 2005R2 with the following components
- Windows Core SDK
- Microsoft Web Workshop (IE) SDK is required because it is referenced in atlbase.h
- (optional) Some folks also install the Debugging tools.
- Eclipse 3.1 or later from www.eclipse.org.
- Java JDK 1.4 (this was built using 1.4.2.09)
Last Modified 10/2005