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.

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

Technology	Where to Get It	Notes
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

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

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.
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
Make sigtest/build the current directory.
Edit the sigtest/build/build.properties file.
- 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.
Execute the ant command.

The output of the build (sigtest-<VERSION>-build directory) 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.

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.

Main Menu