C H A P T E R 6

CLDC Build System

This chapter provides a very brief description of building CLDC. It also includes a section that describes build variables that must match between the CLDC HotSpot Implementation build and the Java Wireless Client software build.

CLDC HotSpot Implementation has its own set of documentation. For detailed information about the build system, read the CLDC HotSpot Implementation Porting Guide.

CLDC Build Overview

The CLDC HotSpot Implementation build system expects you to define three variables:

JDK_DIR is the location of the Java Development Kit software.

JVMWorkSpace is the cldc directory.

JVMBuildSpace is the location of the CLDC HotSpot Implementation build output.

If you build CLDC HotSpot Implementation on top of PCSL, set ENABLE_PCSL to true, and specify where to find PCSL with PCSL_OUTPUT_DIR.

Likewise, if you build CLDC HotSpot Implementation on top of the JavaCall API, tell the build system where to find the JavaCall API with JAVACALL_OUTPUT_DIR.

To perform the build, find the cldc/build subdirectory which corresponds to the platform for which you are building. For example, if you want to build the Java Wireless Client software for Windows, perform the CLDC HotSpot Implementation build in cldc/build/win32_i386.

Mapping Configuration Variables

Some CLDC HotSpot Implementation and Java Wireless Client software features much match.

Record the variables and values you use to build the CLDC HotSpot Implementation. You must use corresponding variables and values when you build the Java Wireless Client software.

In general, the CLDC Hotspot Implementation build options have the prefix ENABLE_, and the Java Wireless Client software build options have the prefix USE_. TABLE 6-1 lists build options in the two build systems.

TABLE 6-1 Configuration Options Mapping Between Build Systems
CLDC HotSpot Implementation	Java Wireless Client Software	Description
`ENABLE_JAVA_DEBUGGER`	`USE_JAVA_DEBUGGER`	Provides KDWP support.
`ENABLE_WTK_PROFILER`	`USE_JAVA_PROFILER`	Provides support for profiling the Java platform.
`ENABLE_MONET`	`USE_MONET`	Provides fast loading class format.
`ENABLE_CLDC_11`	`USE_CLDC_11`	Provides support for the CLDC 1.1 Specification.
`ENABLE_ISOLATES`	`USE_MULTIPLE_ISOLATES`	Provides multitasking functionality.
`ENABLE_VERIFY_ONLY`	`USE_VERIFY_ONCE`	Provides improved MIDlet startup time by preverifying a MIDlet's classes when the MIDlet is installed instead of every time it runs.