Preface

The Java^™ 2 Platform, Micro Edition, Wireless Toolkit Basic Customization Guide describes how to customize the J2ME^™ Wireless Toolkit by modifying device property files.

Who Should Use This Book

This guide is intended for developers who need to configure the J2ME Wireless Toolkit to accommodate device emulators other than the ones provided by the Wireless Toolkit. This document assumes that you are familiar with Java programming, Mobile Information Device Profile (MIDP) and the Connected Limited Device Configuration (CLDC) specifications.

How This Book Is Organized

Chapter 1 describes briefly customization steps, device property files, and the default emulator.

Chapter 2 explains, through a tutorial, how to create device property files that enable the Wireless Toolkit to emulate devices other than the default devices supplied by the toolkit. The tutorial shows you how to obtain and enter image files, screen properties, button properties, soft button label areas, and icon properties. The tutorial also explains how to set color properties and how to run the emulator for the new device.

Chapter 3 describes in depth the components of a device definition and explains how to create a device definition.

Appendix A lists the property files for the default emulator, describes the properties for it, and lists the image and icon files for the default emulator.

Appendix B explains how to add a bytecode obfuscator to the Wireless Toolkit using the framework provided by the toolkit.

Appendix C describes the extension API provided with the Wireless Toolkit that you can use to connect to the Wireless Toolkit’s WMA emulation environment.

Using Operating System Commands

This document may not contain information on basic UNIX® or Microsoft Windows commands and procedures such as opening a terminal window, changing directories, and setting environment variables. See the software documentation that you received with your system for this information.

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.

Shell Prompts

Related Documentation

Shell	Prompt
C shell	machine_name`%`
Microsoft Windows	<directory>


Application	Title
J2ME Wireless Toolkit	J2ME Wireless Toolkit User’s Guide
J2ME Wireless Toolkit	J2ME Wireless Toolkit Release Notes
MIDP - JSR 37	Mobile Information Device Profile for the J2ME™ Platform
MIDP - JSR 118	Mobile Information Device Profile 2.0
CLDC - JSR 30, JSR 139	J2ME™ Connected Limited Device Configuration
WMA - JSR 120	Wireless Messaging API (WMA) for Java™ 2 Micro Edition
MMAPI - JSR 135	Mobile Media API
JTWI - JSR 185	Java Technology for the Wireless Industry
J2ME Web Services JSR 172	J2ME™ Web Services Specification

Accessing Sun Documentation Online

The Java Developer Connection^SM web site enables you to access Java^™ platform technical documentation on the Web.

Sun Welcomes Your Comments

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