Preface

The Tools Guide describes how to use the Sun Java trademark Wireless Client software tools and other executables to configure, run, and test an implementation of the Java Wireless Client software. These executables are not intended for end users. They are for platform developers, system developers, and systems integrators. The executables are unsupported.

Because these unsupported executables are for developers, not end users, they use simple option parsing. The simple parsing of executables might lead to reported error conditions that are not user friendly. The most confusing error condition occurs because the executables only ensure that option values are formatted according to the specification of the underlying MIDP APIs. They accept any potentially valid value for an option, even if the value looks like another option or a value for another option. Like the java command from the Java Platform, Standard Edition (Java SE platform), they do not reject any positive case, which they would have to do to make error messages more user friendly.

Note - Sun Microsystems has simplified the naming schemes for the various Java platforms. Java Platform, Enterprise Edition (Java EE) was formerly Java 2 Platform, Enterprise Edition (J2EE trademark ). Java Platform, Standard Edition (Java SE) was formerly Java 2 Platform, Standard Edition (J2SE). Java Platform, Micro Edition (Java ME) was formerly Java 2 Platform, Micro Edition (J2ME).

References in this guide to specific documents, specifications, and products that were released when the old naming scheme was in use retain their original names. General references to Java platforms in this guide use the new, simplified naming scheme.

Before You Read This Guide

Readers using this guide must be familiar with the MIDP 2.1 Specification. The specification is available from http://www.jcp.org/.

Note - Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials available through such sites.

This guide also assumes that the Java Wireless Client software is installed and an implementation reference port is built as described in the Build Guide.

How This Guide Is Organized

This book contains the following chapters:

Chapter 1 describes how to manage the certificate authority keys needed for secure network protocols and MIDlet authorization.

Chapter 2 describes how to sign a MIDlet suite's Java Archive (JAR) file.

Chapter 3 contains information about converting images to a raw format to optimize performance.

Chapter 4 covers the Skin ROMizer tool which is used during the build.

Chapter 5 describes how to use the command-line executables to manage and run MIDlet suites.

Chapter 6 describes how to connect Java Wireless Client to a debugger.

Chapter 7 describes how to automatically test MIDlet suite management and execution.

Chapter 8 describes how to use a MIDlet that lists and runs certain tests, called I3 tests.

Appendix A describes tools for upgrading configuration files from previous versions of Java Wireless Client.

Application	Title
All	Release Notes
Porting	Porting Guide
Porting Optional Packages	Optional Packages Porting Guide
Building	Build Guide
Configuration and Testing Tools	Tools Guide
Multitasking Integration and Policies	Multitasking Guide
Multitasking Test Tools	Multitasking Quality Test Set Guide
Customizing Adaptive User Interface Technology (skins)	Skin Author's Guide to Adaptive User Interface Technology
Viewing reference documentation created by the Javadoc tool	Java API Reference
Viewing reference documentation created by the Doxygen tool	Native API Reference

Typographic Conventions Used in This Guide

Typeface	Meaning	Examples
`Courier 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`.
`Bold AaBbCc123`	What you type, when contrasted with on-screen computer output Important parts of a code sample	`%` `su` `Password:`
Italic 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 super user to do this. To delete a file, type `rm` filename.

Typeface

Meaning

Examples

Courier 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.

Bold AaBbCc123

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

Important parts of a code sample

% su

Password:

Italic

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 super user to do this.

To delete a file, type rm filename.

Accessing Sun Documentation Online

The Java Developer Connection trademark program web site enables you to access Java platform technical documentation at http://java.sun.com/.

Sun Welcomes Your Comments

We are interested in improving our documentation and welcome your comments and suggestions. Provide feedback to Sun at
http://developers.sun.com/contact/feedback.jsp?&category=j2me.

Before You Read This Guide

How This Guide Is Organized

Related Documentation

Typographic Conventions Used in This Guide

Accessing Sun Documentation Online

Sun Welcomes Your Comments