Building the OpenSAML 2 Library
Build Basics
The OpenSAML 2 source tree comes with a script for invoking Ant on Unix platforms (ant.sh) and Windows platforms (ant.bat). The build provides the following target:
- clean - removes all the build generated content
- javadoc - generated the Javadoc for the library and places in it the
doc/javadoc
directory - test - runs the available unit tests and places the results in the
doc/results
directory - package - generates the OpenSAML java and places it in the
dist
directory
Targeting JDK 1.4
By default the build script will target Java 5.0 (JDK 1.5), if you wish to build the library so that it works with Java2 1.4 (JDK 1.4), simply open the build.properties
file and change the target.jdk property to 1.4.
Note: You must use JDK 1.5 when building !OpenSAML, even if you are targeting JDK 1.4. The build process will downgrade the resulting Java class files using Retroweaver.
Developer Targets
The build script provides the following development related targets
- tgz-src-dist - create a source distribution package in tar gzip'ed (tgz) format and places it in the
dist
directory - tgz-bin-dist - create a binary (i.e. no source files) distribution package in tar gzip'ed (tgz) format and places it in the
dist
directory - zip-src-dist - create a source distribution package in zip format and places it in the
dist
directory - zip-bin-dist - create a binary (i.e. no source files) distribution package in zip format and places it in the
dist
directory