Preface

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

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 in this guide to Java platforms use the new, simplified naming scheme.

Before You Read This Book

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

CLDC 1.1 Specification

MIDP 2.0 Specification

JTWI Specification

CLDC HotSpot Implementation Porting Guide

Skin Author's Guide to Adaptive User Interface Technology

Scalable 2D Vector Graphics API for J2ME Specification

Wireless Messaging API 2.0 Specification

Mobile 3D Graphics API for J2ME Specification

Mobile Media API Specification

Java APIs for Bluetooth Specification

PDA Optional Packages for the J2ME Platform Specification

J2ME Web Services Specification

Security and Trust Services API for J2ME Specification

How This Book Is Organized

This book contains the following chapters and appendices:

Chapter 1 describes the contents of the rest of the book.

Chapter 2 describes how to port the FileConnection and PIM APIs that are defined by JSR 75.

Chapter 3 covers porting the Bluetooth and OBEX APIs from JSR 82.

Chapter 4 contains information about porting the JSR 179 Location API.

Chapter 5 describes porting the JSR 226 SVG API.

Chapter 6 covers porting the JSR 238 Mobile Internationalization API.

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

TABLE P-1
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

TABLE P-2
Shell	Prompt
C shell	`%`

Related Documentation

The following documentation is included with this release:

TABLE P-3
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 Javadoc tool	Java API Reference
Viewing reference documentation created by the Doxygen tool	Native API Reference

In addition, you might find the following documentation helpful:

The Java Language Specification (Java Series), Second Edition by James Gosling, Bill Joy, Guy Steele and Gilad Bracha. Addison-Wesley, 2000,
http://java.sun.com/docs/books/jls/index.html

The Java Specification Request (JSR), (J2ME Connected, Limited Device Configuration) at http://jcp.org/jsr/detail/30.jsp (JSR 30)

Mobile Information Device Profile 2.0, at
http://jcp.org/jsr/detail/118.jsp (JSR 118)

Java Technology for the Wireless Industry, at
http://jcp.org/jsr/detail/185.jsp (JSR 185)

A full list of JSRs for the Java ME platform, available at
http://jcp.org/jsr/tech/j2me.jsp

KVM Debug Wire Protocol (KDWP) Specification, Sun Microsystems, Inc., available as part of the CLDC (Connected Limited Device Configuration) download package.

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.