Preface

This book describes how to create build Sun Java trademark Wireless Client Software from its source code. This guide assumes that the product is installed on a system that meets the hardware and software requirements described in the Release Notes.

Before You Read This Guide

Readers using this guide must be familiar with the MIDP 2.0 Specification.

How This Book Is Organized

Chapter 1 describes the build environment.

The next three chapters are designed to help you hit the ground running, so you can quickly navigate an entire build and run Java Wireless Client software.

Chapter 2 illustrates how to build and run on Windows.

Chapter 3 describes how to build and run on Linux.

Chapter 4 shows how to build on Linux to run on an ARM device.

The last three chapters in this book provide a more thorough and systematic description of the various pieces of the Java Wireless Client software build system.

Chapter 5 describes how to build the Portable Common Services Layer (PCSL).

Chapter 6 describes how to build the Connected Limited Device Configuration HotSpot trademark Implementation.

Chapter 7 describes how to build the Java Wireless Client software.

Operating System Commands

This document does not contain information on basic 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.

Shell Prompts

Shell	Prompt
Bourne shell and Korn shell	`$`
Windows	directory`>`

Table showing examples of the types of shell prompts used in this document.

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.

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.

Table showing examples and descriptions of the typographic conventions used in this document.

Application	Title
All	Release Notes
Porting	Porting Guide
Building	Build Guide
Using Tools	Tools Guide
Using Adaptive User Interface Technology	Skin Author's Guide
Using Multitasking Features	Multitasking Guide
Using MT-QTS	MT-QTS Test Suite Guide
Viewing reference documentation created by the Javadoc tool	Java API Reference
Viewing reference documentation created by the Doxygen tool	Native API Reference

Third-Party Web Sites

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

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 at
http://developers.sun.com/contact/feedback.jsp?&category=j2me.