Chapter   2

Installation Notes

2.1 General Comments

The CLDC reference implementation source code release is aimed primarily at device manufacturers and other companies and individuals who want to port a small-footprint, general-purpose Java platform implementation onto their devices and platforms.

This release package contains the full source code of the K Virtual Machine and CLDC libraries, as well as a KVM Porting Guide document that is intended to help you in platform-specific porting efforts. The package does not contain the MIDP APIs or any other J2ME profile APIs that you may need for building a complete J2ME implementation for a particular target device.

If you are not interested in porting efforts and are looking for a more “end-user-friendly” release package for J2ME application development, we encourage you to download and use one or both of the following packages:

J2ME Wireless Toolkit
http://java.sun.com/products/j2mewtoolkit/
MIDP for Palm OS
http://java.sun.com/products/midp/palmOS.html

The installation instructions below are applicable only to those situations in which you intend to build the CLDC reference implementation from source code.

2.2 Unzipping the Distribution

Unzip the distribution into any directory of your choice. It creates the directory j2me_cldc with the following subdirectories:

api
bin
build
docs
jam
kvm
samples
tools

Please refer to the KVM Porting Guide for further information on the contents of these directories.

2.3 Building the Source Code Release

The K Virtual Machine and the associated preverification tool have been written in the C programming language. This software has been compiled successfully with the following compilers:

Sun C Compiler 5.0, 5.2 and 5.3 on Solaris,
GNU C 2.91.66 (egcs-1.1.2) compiler on Red Hat Linux,
GNU C 2.95.2 compiler on Solaris and Windows NT 4.0,
Microsoft Visual C++ 6.0 Professional on Windows NT 4.0 and Windows 2000.

In order to compile the Java library files, sample applications, and additional tools provided in the source release, Java Development Kit (JDK) 1.2.2 or later is required.

You should be able to build all the binaries included in this release from the source code files shipped with the release. The necessary GNU tools for building the binaries are not provided with this release, but can be downloaded from

http://www.gnu.org/software/software.html

or

http://sources.redhat.com/cygwin.

2.3.1 Building the Release on Red Hat Linux

Enter the build/linux subdirectory and type gnumake.

2.3.2 Building the Release on Solaris

Enter the build/solaris subdirectory and type gnumake.

2.3.3 Building the Release on Windows 2000

Enter the build/win32 subdirectory and type gnumake.

2.4 Most Commonly Used Build Options

The following parameters are commonly used when using gnumake to build the KVM.

 
gnumake ROMIZING=false 

Build the KVM with ROMizing disabled, that is, without linking all the system library classes statically into the KVM executable.

 
gnumake DEBUG=true 

Build the KVM with the Java-level debugger interface enabled.

 
gnumake USE_JAM=true 

Build the KVM with the Java Application Manager (JAM) enabled.

 
gnumake GCC=true 

Use GNU C compiler when compiling the KVM source code.

 
gnumake USE_KNI=true 

Build the KVM with the K Native Interface (KNI) enabled.

For more information on build options, as well as the various KVM compilation options, please refer to the KVM Porting Guide.

Release Notes CLDC, 1.0.4

Copyright © 2002 Sun Microsystems, Inc. All rights reserved.