Page History

• 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
• Download and extract the remainder of the software listed in the Requirements section.
• Make JTHarness/build the current directory.
• Edit the JTHarness/build/local.properties file.

• The BUILD_DIR property specifies where the build distribution is generated. You may change this as appropriate. If you leave the value undefined, a default location is created under the same parent directory as your working copy.
• Set a property named jhalljar that contains the path to the JavaHelp software jhall.jar library.
• Set a property named jhjar that contains the path to the JavaHelp software jh.jar library.
• Set a property named jcommmjar jcommjar to point to the Java Communications API JAR file (typically, comm.jar). This is required for compilation even if you are not using serial communications in your test suite.
• Set a property named servletjar to point to the Java EE JAR file (javaee.jar). This is required for compilation but is not required at run time. Alternate sources of the javax.servlet package can also be used.
• Set a property named bytecodelib to include both path/asm-3.1.jar and path/asm-commons-3.1.jar. The paths are separated by a colon. This library is used for runtime identification of JUnit tests if required. This is a compile-time requirement, and is not needed at runtime unless you are using that section of the JT harness JUnit libraries.
• Set a property named junitlib to point to junit-4.4.jar. This library is used to compile the JT harness JUnit library classes packaged in jt-junit.jar, not in javatest.jar. It is a compile-time requirement, and is not needed at runtime unless you are using that section of the JT Harness JUnit libraries.

  Note: When assigning paths to the properties described in this section, use absolute path names and separate multiple items with a colon.

• Execute the ant command (see Additional Build Targets).

• bundles/ -- Contains the generated jtharness.zip archive. This Zip archive contains the entire JT harness distribution including documentation, examples, and sample code. Note that the contents of the Zip bundle is extracted into the current directory.
• binaries/ -- Contains the entire unbundled distribution. It includes the binary and documentation files required to execute the JT harness. The JT harness binary (javatest.jar) is generated into the following location:

  ../../JTHarness-build/binaries/lib/javatest.jar

Run the JT Harness

You can run the JT Harness in the following ways:

• Specify the "run" target in the Ant build. For more information see Additional Build Targets.
• Run it from the command line:

  % java -jar path/javatest.jar

Refer to the sample test suites in the examples directory to see how JT harness can be used in a test suite.

Additional Build Targets

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