Preface

This document describes how to work with the Sun Java trademark 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 Java^TM 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:

http://java.sun.com/learning/new2java/

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

http://developers.sun.com/techtopics/mobility/learn/midp/midp20/

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 J2ME trademark , 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:

http://developers.sun.com/techtopics/mobility/

TABLE P-1 Related Documentation
Topic	Title
Customizing the Sun Java^TM Wireless Toolkit for CLDC	Sun Java^TM Wireless Toolkit for CLDC Basic Customization Guide
Release Notes	Sun Java^TM 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
MMAPI - JSR 135	Mobile Media API
J2ME Web Services - JSR 172	J2ME Web Services Specification
SATSA - JSR 177	Security and Trust Services APIs for J2ME
Location API - JSR 179	Location API for J2ME
SIP API - JSR 180	SIP 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
SVG API - JSR 226	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 Java^TM 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 Java^TM 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 Java^TM Wireless Toolkit for CLDC.

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

Appendix C describes localization features in the Sun Java^TM Wireless Toolkit for CLDC.

Typographic Conventions

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

TABLE P-2 Typographic Conventions
Typeface	Meaning	Examples
`AaBbCc123`	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`.
`AaBbCc123`	What you type, when contrasted with on-screen computer output	`%` `su` `Password:`
AaBbCc123	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.
AaBbCc123	Command-line variable; replace with a real name or value	To delete a file, type `rm` filename.
{AaBbCc.dir}	Variable file names and directories.	In this book, toolkit always refers to the directory where the Sun Java^TM 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:

http://developer.sun.com/

http://java.sun.com/javame/

We Welcome Your Comments

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