Building with the REF Kit

Use the following general procedure to set up your development and testing environment. Refer to the JDK and Ant documentation for detailed instructions.

Set Up Development and Testing Environment:

1. Install JDK 1.5 or higher.

2. Install Apache Ant 1.6.3 or higher.

3. Set the JAVA_HOME environment variable to point to the JDK. For example:

   JAVA_HOME=c:\jdk-1.5.0_x

4. Set the ANT_HOME environment variable to point to Ant. For example:

   ANT_HOME=c:\apache-ant-1.6.3

5. Add JAVA_HOME\bin and ANT_HOME\bin the PATH environment variable.

6. Install the REF kit.

   mkdir spe-dev copy idmspe-refkit.zip spe-dev cd spe-dev unzip idmspe-refkit.zip

   You are now ready to change directories to spe-dev and run ant. You may run ant with or without an optional target. To specify a target, enter ant TargetName, such as ant compile. If you do not specify a target, ant will build everything in the src directory and create a JAR file in a new directory, dist.

   The following table lists the possible targets.

   Target	Description
   init	Initializes the build environment by creating dependent directories.
   compile	Compiles all source in the src directory into the build directory.
   resources	Copies all non-Java source files into the build directory. This is for properties file support and other embedded resources.
   dist	Create a JAR file from the files in the build directory into the dist directory. The name of the JAR will be the project name specified at the top of the build.xml file “MyProject” and a timestamp.
   clean	Removes the dist, build, and reports directories and remove all .class files from the test directory.
   test	Calls the compile, resources, test-compile, and test-run targets (in that order), then runs the JUnit reports task on the results to produce both HTML and text reports on the success or failure of the tests. The reports are written to the reports directory.
   test-run	Calls the compile, resources, and test-compile targets. Then it runs each test case within the test directory whose file name contains the pattern *Tests.java.
   test-compile	Calls the compile, and resource targets, then compiles all the files within the test directory.