Before You Begin

This document provides a tutorial for the Fortetrademark for Javatrademark 4, Mobile Edition integrated development environment (IDE). It is meant for those readers learning the IDE. Topics covered in the tutorial include:

This document instructs you to enter several commands at the command line. Command lines vary slightly from one platform to another. For example, a Microsoft Windows command might look like this:

c:\>cd MyWorkDir\MyPackage

To translate for UNIX® or Linux environments, simply change the prompt and use forward slashes:

% cd MyWorkDir/MyPackage


Before You Read This Book

To use this tutorial, you should have installed the Forte for Java 4, Mobile Edition product. See the Forte for Java 4, Mobile Edition Getting Started Guide for information on how to perform this installation.

The Forte for Java 4, Mobile Edition IDE, referred to hereafter as the Mobile Edition IDE, integrates the Forte for Java 4 IDE with the Java 2 Micro Edition (J2MEtrademark) platform and the J2ME Wireless Toolkit (WTK). The Mobile Edition IDE supports developing applications for handheld, wireless devices.

Currently, the IDE supports the J2ME platform for the Mobile Information Device Profile (MIDP) with the Connected, Limited Device Configuration (CLDC). CLDC is a standardized and portable minimum-footprint Java environment designed for small, resource-constrained devices. It runs on top of Sun's K Virtual Machine (KVM). MIDP is a set of Java APIs that work with CLDC to provide a complete J2ME application runtime environment targeted for mobile information devices such as cellular phones and two-way pagers. The MIDP APIs provide a standard way to address issues such as user interface, persistence storage, networking, and application life cycle.

Before starting, you should be familiar with the following subjects:

  • Java programming language
  • Java 2 Micro Edition platform
  • MIDP applications
  • J2ME application assembly and deployment concepts

This book requires a knowledge of J2ME technology and wireless concepts. Refer to the following web site for more information:

http://java.sun.com/j2me/



Note - 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 on or available from such sites or resources. Sun will not be responsible or liable for any damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services available on or through any such sites or resources.




How This Book Is Organized

Chapter 1 provides the information necessary to set up the Forte for Java 4, Mobile Edition and to use the Mobile Edition IDE to create and test a MIDlet and a MIDlet suites.

Chapter 2 describes how to debug a MIDlet application using the Mobile Edition IDE's debugger.

Chapter 3 discusses advanced issues, including Over-the-Air support and working with projects.

Appendix A provides the source code for the ConverterMIDlet application and its Java classes.


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

Read Chapter 6 in the User's Guide.

These are called class options.

You must be superuser to do this.

AaBbCc123

Command-line variable; replace with a real name or value

To delete a file, type rm filename.



Related Documentation

Forte for Java 4 documentation includes books delivered in Acrobat Reader (PDF) format, online help, readme files of example applications, and Javadoctrademark documentation.

Documentation Available Online

The documents in this section are available from the Forte for Java 4 portal and the docs.sun.comSM web site.

The documentation link of the Forte for Java Developer Resources portal is at http://forte.sun.com/ffj/documentation/. The docs.sun.com web site is at http://docs.sun.com.

  • Release notes (HTML format)
Available for each Forte for Java 4 edition. Describe last-minute release changes and technical notes.
  • Forte for Java 4, Mobile Edition Getting Started Guide (PDF format) -
    part no. 816-4338-10.
Describes how to install the Forte for Java 4, Mobile Edition product on each supported platform and includes other pertinent information, such as system requirements, upgrade instructions, command-line switches, installed subdirectories, Javadoc setup, and information on how to use the Update Center.

You can also find the completed tutorial applications at http://forte.sun.com/ffj/documentation/tutorialsandexamples.html

The docs.sun.com web site (http://docs.sun.com) enables you to read, print, and buy Sun Microsystems manuals through the Internet. If you cannot find a manual, see the documentation index installed with the product on your local system or network.

Online Help

Online help is available inside the Forte for Java 4 development environment. You can access help by pressing the help key (Help in a Solaris environment, F1 on Microsoft Windows and Linux), or by choosing Help right arrow Contents. Either action displays a list of help topics and a search facility.

Examples

You can download several examples that illustrate a particular Forte for Java 4 feature, as well as the source files for the tutorial applications from the Developer Resources portal, at:

http://forte.sun.com/ffj/documentation/tutorialsandexamples.html

Javadoc Documentation

Javadoc documentation is available within the IDE for many Forte for Java 4 modules. Refer to the release notes for instructions on installing this documentation. When you start the IDE, you can access this Javadoc documentation within the Javadoc pane of the Explorer.


Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. Email your comments to Sun at this address:

docfeedback@sun.com

Please include the part number (816-5081-10) of your document in the subject line of your email.