This document describes how to work with the Sun Javatrademark Wireless Toolkit for CLDC.

Who Should Use This Book

This guide is intended for developers creating Mobile Information Device Profile (MIDP) applications with the Sun JavaTM Wireless Toolkit for CLDC. This book is not a tutorial in MIDP programming, nor is it a tutorial in programming any of the additional APIs that are supported by the toolkit. You should already understand how to use the Mobile Information Device Profile (MIDP) and the Connected Limited Device Configuration (CLDC).

If you need help getting started with the Java programming language, try the New to Java Center:

For a quick start with MIDP programming, read Learning Path: Getting Started with MIDP 2.0:

Related Documentation

This section lists related Java Platform, Micro Edition (Java ME) specifications. Java ME was formerly referred to as the Java 2 Platform, Micro Edition, or J2MEtrademark, as you see in some of the specification names. Although specifications are definitive, they are not always the most accessible kind of information. For a variety of developer-centered articles, try Sun's mobility web site:

TABLE P-1 Related Documentation



Customizing the Sun JavaTM Wireless Toolkit for CLDC

Sun JavaTM Wireless Toolkit for CLDC Basic Customization Guide

Release Notes

Sun JavaTM Wireless Toolkit for CLDC Release Notes

CLDC 1.0 - JSR 30

J2ME Connected Limited Device Configuration

MIDP 1.0 - JSR 37

Mobile Information Device Profile for the J2ME Platform

PDAP Optional Packages - JSR 75

PDA Optional Packages for the J2ME Platform

Bluetooth and OBEX - JSR 82

Java APIs for Bluetooth

MIDP 2.1 - JSR 118

Mobile Information Device Profile 2.0
(Final Release 2 is referred to as MIDP 2.1)

CLDC 1.1 - JSR 139

J2ME Connected Limited Device Configuration


Mobile Media API

J2ME Web Services - JSR 172

J2ME Web Services Specification


Security and Trust Services APIs for J2ME

Location API - JSR 179

Location API for J2ME



Mobile 3D Graphics - JSR 184

Mobile 3D Graphics API for J2ME

JTWI - JSR 185

Java Technology for the Wireless Industry

WMA 2.0 - JSR 205

Wireless Messaging API (WMA)

CHAPI 1.0 - JSR 211

Content Handler API


Scalable 2D Vector Graphics API for J2ME

Payment API - JSR 229

Payment API

Advanced Multimedia - JSR 234

Advanced Multimedia Supplements

Mobile Internationalization - JSR 238

Mobile Internationalization API

Java Binding for OpenGL® ES API - JSR 239

Java Binding for OpenGL® ES API

Mobile Service Architecture
- JSR 248

Mobile Service Architecture

How This Book Is Organized

This guide contains the following chapters and appendices:

Chapter 1 introduces the Sun JavaTM Wireless Toolkit for CLDC and the development features it provides.

Chapter 2 describes the development processes for creating and running MIDlets.

Chapter 3 explains how to work with projects in the toolkit. You'll learn how to adjust project properties, manipulate MIDlets, work with the push registry, and understand the project directory structure.

Chapter 4 describes the emulator and explains how to adjust its options and take advantage of its many features.

Chapter 5 shows how you can examine the performance of your application using the method profiler, memory monitor, and network monitor.

Chapter 6 describes how to sign MIDlet suites and manage keys and certificates.

Chapter 7 details support for running and testing wireless messaging applications.

Chapter 8 explains how the Sun JavaTM Wireless Toolkit for CLDC supports the Mobile Media API.

Chapter 9 contains information about developing 3D graphics content.

Chapter 10 describes how the toolkit implements access to local files and personal information like contacts and calendar appointments.

Chapter 11 covers the toolkit's Bluetooth and OBEX simulation environment.

Chapter 12 shows how to use the web services stub generator.

Chapter 13 describes how to work with the emulator's location features.

Chapter 14 discusses the toolkit's support for SATSA.

Chapter 15 covers the toolkit's SIP support.

Chapter 16 describes the toolkit's Payment API features.

Chapter 17 shows how to manage resources for the Mobile Internationalization API.

Appendix A describes the application demonstrations that are included in the Sun JavaTM Wireless Toolkit for CLDC.

Appendix B explains how to use the functionality of the Sun JavaTM Wireless Toolkit for CLDC from the command line.

Appendix C describes localization features in the Sun JavaTM Wireless Toolkit for CLDC.

Typographic Conventions

TABLE P-2 describes font uses cases in this document.

TABLE P-2 Typographic Conventions





The names of commands, files, and directories; on-screen computer output

Edit your .login file.

Use ls -a to list all files.

% You have mail.


What you type, when contrasted with on-screen computer output

% su



Book titles, new words or terms, words to be emphasized.

Read Chapter 6 in the User's Guide.

These are called class options.

You must be superuser to do this.

Command-line variable; replace with a real name or value

To delete a file, type rm filename.


Variable file names and directories.

In this book, toolkit always refers to the directory where the Sun JavaTM Wireless Toolkit for CLDC is installed. workdir refers to a user's working directory, as explained in Section 1.1.1, The Installation Directory and the Working Directory.

Accessing Sun Documentation Online

The following sites provide technical documentation related to Java technology:

We Welcome Your Comments

We are interested in improving our documentation. Email your feedback from