Building a CLDC Reference Port (phoneME Feature MR4)

Building a CLDC Reference Port (phoneME Feature MR4)

 

CLDC software is the OSS community version of Sun Microsystems' Connected Limited Device Configuration HotSpot Implementation virtual machine.

This document has the following sections:

  * Building CLDC Software on a Windows x86 Build Platform
  * Building CLDC Documentation

For more information about building and running CLDC, see CLDC HotSpot Implementation software documentation.

Building CLDC Software on a Windows x86 Build Platform

Building a default version of CLDC creates the CLDC software executable cldc_vm.exe for the JavaCall porting layer on a Windows x86 target platform. To properly build the CLDC software on a Windows x86 build platform, you must set the environment variables shown in TABLE 4-1.

TABLE 4-1Required CLDC Build Variables for Windows x86

Name
 

Description

JVMWorkSpace
 

The location of your CLDC software source code workspace. For example, JVMWorkSpace=%COMPONENTS_DIR%/cldc.

JVMBuildSpace
 

The location of your CLDC software build output. For example, JVMBuildSpace=%BUILD_OUTPUT_DIR%/cldc.

ENABLE_PCSL
 

Required for building CLDC with the PCSL software component. Must be set to true.
PCSL_OUTPUT_DIR  

The location of PCSL build output. Required for building CLDC if ENABLE_PCSL=true. For example, PCSL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/pcsl.

ENABLE_ISOLATES
 

Required for building a CLDC implementation with multitasking capability. Must be set to true. If not explicitly set to true, the build defaults to false and CLDC is built without multitasking capability.

Note: If you set ENABLE_ISOLATES=true to build a CLDC implementation with multitasking capability, you must also set USE_MULTIPLE_ISOLATES=true to build the phoneME Feature software, as described in Building a phoneME Feature Reference Port.

JAVACALL_OUTPUT_DIR

 

The location of JavaCall porting layer output. For example, JAVACALL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/javacall.

TOOLS_DIR
 

Defines the directory where needed build tools are located. For example, TOOLS_DIR=%COMPONENTS_DIR%/tools.

TOOLS_OUTPUT_DIR
 

Defines a directory location for tools-specific output. For example, TOOLS_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/tools.

USE_VS2005
 

Tells the build system to use Microsoft Visual Studio 2005 as the default compiler. For example, USE_VS2005=true.

ENABLE_JAVA_DEBUGGER
 

Supports the use of the emulator binary plugin. For example, ENABLE_JAVA_DEBUGGER=true.

ENABLE_MULTIPLE_PROFILES_SUPPORT
 

Supports the use of the emulator binary plugin. For example, ENABLE_MULTIPLE_PROFILES_SUPPORT=true.

Building CLDC for a Windows x86 Target Platform

  1. Set the JVMWorkSpace variable, as shown here.

  $ set JVMWorkSpace=%COMPONENTS_DIR%/cldc

  2. Set the JVMBuildSpace variable, as shown here.

  $ set JVMBuildSpace=%BUILD_OUTPUT_DIR%/cldc

  3. Run the make command as a single command-line string, as shown here.

  $ make -C %JVMWorkSpace%/build/javacall_i386_vc ENABLE_PCSL=true PCSL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/pcsl ENABLE_ISOLATES=true JAVACALL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/javacall TOOLS_DIR=%COMPONENTS_DIR%/tools TOOLS_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/tools USE_VS2005=true ENABLE_JAVA_DEBUGGER=true ENABLE_MULTIPLE_PROFILES_SUPPORT=true 

The generated CLDC output is found under %JVMBuildSpace%/javacall_i386_vc/dist.

Running CLDC Software

Once you build the CLDC software, you can invoke it from the command line to run a class compiled from the Java programming language. The path to the executable depends on the target platform (operating system and processor) for which you build the software.

Running CLDC on a JavaCall porting layer on Windows x86 Target Platform

  1. Change to the CLDC build space for the JavaCall porting layer on Windows x86 platform:

  $ cd %JVMBuildSpace%/javacall_i386/dist

  2. Enter the following command:

  $ bin/cldc_vm.exe -classpath location-of-compiled-applications/classes classname

  For example, to run the HelloWorld application:

  $ bin/cldc_vm -classpath C:/src/classes HelloWorld 

Building CLDC Documentation

You can create HTML documents from CLDC porting interfaces. To do this for the CLDC software, use the make docs_html build target.

Generating Javadoc Tool Documentation

Building Javadoc tool documentation is the same for all build platforms.

  1. Change to the default build directory for your build platform.

  For example, this could be a Linux on i386 platform, as shown here.

  $ cd %JVMWorkSpace%/build/linux_i386

  2. Build Javadoc tool HTML documentation.

  $ make docs_html

Viewing phoneME Feature Documents

Use any browser to display the Javadoc tool output file at the following URL:

  file://%JVMBuildSpace%/doc/javadoc/html/index.html