SigTest Tool Build Instructions

This page describes how to build the SigTest tool binary. Some notes before you get started:

• In order to contribute code to the project you must have a contributor role. See Mobile & Embedded Community Governance for information about the different community roles.
• For a description of how the SigTest tool repository is organized, read SigTest Tool Repository Structure.
• The SigTest Tool Developer's Guide describes how the source code is organized and provides important information for developers who want to modify the code.
• The SigTest Tool Source Code Description describes how the SigTest tool source code is organized.

Table of Contents

Requirements

The SigTest tool build requires the technologies listed in the following table.

Technology	Where to Get It
Ant version 1.6.5 or later	http://ant.apache.org/
JDK version 5.0	http://java.sun.com/j2se/1.5.0/
JDK version 1.4.2 (optional)	http://java.sun.com/j2se/1.4.2/download.html
CDC Reference Implementation 1.1 (JSR 218) (optional, Linux) OR Sun Java Toolkit 1.0 for CDC (optional, Windows)	http://java.sun.com/javame/downloads/index.jsp

Checking out the source

The SigTest tool repository is located on OpenJDK servers, in the CodeTools Project.  It is stored in mercurial vcs, and can be uploaded from mercurial via the following command:

  % hg clone http://hg.openjdk.java.net/code-tools/sigtest

Configure and Run the Build

The following steps describe how to build SigTest tool. These instructions assume that your SigTest tool local working copy is named sigtest.

1. Set up and configure the JDK 5.0, JDK 1.4.2 (optional), and CDC Reference Implementation 1.1 (JSR 218) (optional).
   • Download and install the JDKs and/or CDC RI.
   • Set the environment variable JAVA_HOME to point to the JDK 5.0.
2. Set up and configure the Ant software.
   • Download and install the Ant software.
   • Set your execution path so that it contains the ant command. For example: ANT-dist-path/bin/ant
3. Make sigtest/build the current directory.
4. Edit the sigtest/build/build.propertiesfile.
   • The jdk5.home property specifies where the JDK 5.0 is located.
   • The optional jdk4.home property specifies where the JDK 1.4.2 is located. Only needed if you wish to run SigTest for Java SE 1.4 libraries, specify.
   • The optional cdc.boot property specifies bootclasspath used to compile classes for testing CDC libraries. If not specifed, built SigTest will not support CDC classes testing.
5. Execute the ant command.

The output of the build (sigtest-<VERSION>-builddirectory) contains the following files and subdirectories:

• sigtest-<VERSION>.zip -- SigTest distribution file. Contains examples, javadocs, sigtest.jar, sigtestdev.jar and basic documentation files.
• release/ -- Unpacked SigTest distribution.
• temp/ -- Temporary build directory.

Additional Build Targets

The following additional targets are available. You might wish to identify these targets to your IDE (for example, NetBeans).

Build Target	Description
build (default)	Builds all binaries, doc and distributions.
clean	Removes the entire build directory.
help	Prints the usage message.
bin	Produces binaries.
devbuild	Produces binaries and javadocs.
javadoc	Produces javadocs.
test	Performs sanity test.