Preface

This guide describes how to port Sun Java Wireless Client Software 2.0 to your mobile device.


Before You Read This Book

To fully use the information in this document, you must have thorough knowledge of the topics discussed in these documents:


How This Book Is Organized

This book contains the following chapters and appendices:

Chapter 1 is a basic overview of the Java Wireless Client software and how it works.

Chapter 2 lists the hardware and software required to successfully port the software, and describes some limitations of the software

Chapter 3 documents how the source base is organized and the conventions used for naming native files.

Chapter 4 documents the design and use of the runtime security service.

Chapter 5 documents how to manage properties and constants in Java Wireless Client software with a tool called the configurator.

Chapter 6 is an overview of the porting process. This chapter provides a high-level strategy for porting the Java Wireless Client software to your device.

Chapter 8 documents the Portable Common Services Library (PCSL) and its use in the porting process.

Chapter 9 documents the design and porting of the networking subsystem of the Java Wireless Client software.

Chapter 10 documents the design and porting of the event processing service.

Chapter 11 documents native resource management policies use for multitasking.

-C H A P T E RChapter 12 documents how to implement graphics, images, and fonts using PutPixel technology.

Chapter 13 documents the low-level graphics and images service.

Chapter 14 documents the design and porting of the game subsystem of the Java Wireless Client software.

Chapter 15 documents how to port the high-level user interface using Adaptive User Interface Technology software (AUI Technology software).

Chapter 16 documents how to port the high-level user interface using platform components.

Chapter 17 documents the design of and strategies for porting the record management (RMS) subsystem.

Chapter 18 documents how the runtime security service uses permission management.

Chapter 19 documents the design and porting of the application management service (AMS) subsystem.

Chapter 20 documents the design and porting of the MIDlet auto invocation subsystem of the Java Wireless Client software.

Chapter 21 documents the design and porting of the user message bundle subsystem used for internationalizing the Java Wireless Client software.

Chapter 22 documents the design and porting of the logging and tracing subsystem of the Java Wireless Client software.

Appendix A describes how to analyze and tune the performance of the Java Wireless Client software.


Using Operating System Commands

This document does not contain information on basic UNIX® operating system 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


Shell

Prompt

C shell

%



Related Documentation

The following documentation is included with this release:


TABLE P-1

Application

Title

All

Release Notes

Building Java Wireless Client software

Build Guide

Porting Java Wireless Client software

This book

Viewing reference documentation created by the Javadoctrademark tool

Java API Reference

Viewing reference documentation created by the Doxygen tool

Native API Reference


In addition, you might find the following documentation helpful:


Accessing Sun Documentation Online

The Source for Java Developers web site enables you to access Java platform technical documentation on the web at
http://java.sun.com/reference/docs/index.html.


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.