## Preface

This document describes how to work with the J2ME Wireless Toolkit.

## Who Should Use This Book

This guide is intended for developers creating Mobile Information Device Profile (MIDP) applications with the J2ME Wireless 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 Java programming, 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 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. This section lists related specifications. 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/

Topic | Title
--- | ---
Customizing the J2ME Wireless Toolkit | J2ME Wireless Toolkit Basic Customization Guide
Release Notes | J2ME Wireless Toolkit Release Notes
MIDP 1.0 - JSR 37 | Mobile Information Device Profile for the J2ME™ Platform
MIDP 2.0 - JSR 118 | Mobile Information Device Profile 2.0
CLDC 1.0 - JSR 30 | J2ME Connected Limited Device Configuration
CLDC 1.1 - JSR 139 | J2ME Connected Limited Device Configuration
WMA 2.0 - JSR 205 | Wireless Messaging API (WMA)
MMAPI - JSR 135 | Mobile Media API
JTWI - JSR 185 | Java Technology for the Wireless Industry
J2ME Web Services JSR 172 | J2ME Web Services Specification
PDAP Optional Packages - JSR 75 | PDA Optional Packages for the J2ME Platform
Bluetooth and OBEX - JSR 82 | Java APIs for Bluetooth
Mobile 3D Graphics - JSR 184 | Mobile 3D Graphics API for J2ME

## How This Book Is Organized

This guide contains the following chapters and appendixes:

Chapter 1 introduces the J2ME Wireless Toolkit 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 KToolbar. 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 J2ME Wireless Toolkit 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 12 shows how to use the web services stub generator.

Appendix A describes the application demonstrations that are included in the J2ME Wireless Toolkit.

Appendix B explains how to use the functionality of the J2ME Wireless Toolkit from the command line.

Appendix C describes internationalization features in the J2ME Wireless Toolkit.

## 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 Command-line variable; replace with a real name or value | Read Chapter 6 in the User’s Guide. These are called class options. You must be superuser to do this. To delete a file, type `rm` filename.
{AaBbCc.dir} | Variable file names and directories. | In the book, {toolkit} always refers to the installation directory of the J2ME Wireless Toolkit.

##

## Accessing Documentation Online

The following sites provide technical documentation related to Java technology.

http://developer.sun.com/

http://java.sun.com/docs/

## We Welcome Your Comments

We are interested in improving our documentation and welcome your comments and suggestions. You can email your comments to us at:

wtk-comments@sun.com

| J2ME Wireless Toolkit User's Guide J2ME Wireless Toolkit 2.2

Copyright © 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to the license terms.