Sun Logo


Sun Java Wireless Toolkit for CLDC User's Guide

Sun JavaTM Wireless Toolkit for CLDC

Version 2.5.2

 



Contents

Preface

1. Introduction

1.1 About the Multiple User Environment

1.1.1 The Installation Directory and the Working Directory

1.1.2 Working Directory Files

1.2 Quick Start

1.3 Toolkit Components

1.4 Toolkit Features

1.5 Toolkit Updates

1.6 Supported Technology

2. Developing MIDlet Suites

2.1 About Projects

2.2 Simple Development Cycle

2.2.1 Edit Source Code

2.2.2 Build

2.2.3 Run

2.3 Full Development Cycle

2.3.1 Package

2.3.2 Install

2.3.3 Run

2.4 Creating a Project from a MIDlet Suite

2.5 Using an Obfuscator

2.5.1 Installing ProGuard

2.5.2 Using ProGuard

2.6 Using a Debugger

2.7 Deploying Applications on a Web Server

3. Working With Projects

3.1 Selecting APIs

3.2 Changing MIDlet Suite Attributes

3.3 Manipulating MIDlets

3.4 Using the Push Registry

3.5 Setting Up Content Handlers

3.6 Project Directory Structure

3.7 Using Third-Party Libraries

3.7.1 Using External APIs

3.7.2 Third-Party Libraries for One Project

3.7.3 Third-Party Libraries for All Projects

3.8 Configuring the Wireless Toolkit

3.8.1 Changing the Console Font

3.8.2 Setting the Application Directory

3.8.3 Setting the javac Encoding Property

3.8.4 Working with Revision Control Systems

4. Using the Emulator

4.1 Emulator Skins

4.2 Emulator Controls

4.3 Setting Emulator Preferences

4.3.1 Network Proxies

4.3.2 Storage Sizes

4.3.2.1 Persistent Storage

4.3.2.2 Heap Size

4.3.3 Adjusting Emulator Performance

4.4 Pausing and Resuming

4.5 Running the Emulator Solo

4.6 Using Third-Party Emulators

5. Monitoring Applications

5.1 Using the Profiler

5.1.1 Call Graph

5.1.2 Execution Time and Number of Calls

5.1.3 Saving and Loading Profiler Information

5.2 Using the Memory Monitor

5.2.1 Saving and Loading Memory Monitor Information

5.3 Using the Network Monitor

5.3.1 Filtering Messages

5.3.2 Sorting Messages

5.3.3 Saving and Loading Network Monitor Information

5.3.4 Clearing the Message Tree

6. Security and MIDlet Signing

6.1 Permissions

6.2 Selecting the Security Policy

6.2.1 MSA Protection Domains

6.2.2 Java for the Wireless Toolkit Industry Protection Domains

6.3 Signing a MIDlet Suite

6.4 Managing Keys

6.4.1 Creating a New Key Pair

6.4.2 Getting Real Keys

6.4.3 Importing an Existing Key Pair

6.4.4 Removing a Key Pair

6.5 Managing Certificates

6.5.1 Enabling and Disabling Certificates

6.5.2 Importing Certificates

6.5.3 Removing Certificates

6.6 USB Token Support

6.6.1 Installing USB Token Drivers

6.6.2 Using the USB Token

7. Using the Wireless Messaging API

7.1 Setting Emulator Phone Numbers

7.2 Simulating an Unreliable Network

7.3 Sending Messages With the WMA Console

7.3.1 Sending a Text SMS Message

7.3.2 Sending a Binary SMS Message

7.3.3 Sending Text or Binary CBS Messages

7.3.4 Sending MMS Messages

7.4 Receiving Messages in the WMA Console

7.5 Using the Network Monitor with WMA

8. Using the Mobile Media API

8.1 Supported Formats and Protocols

8.2 Adaptive Multi-Rate (AMR) Content

8.2.1 Windows

8.2.2 Linux

8.2.2.1 Enabling AMR Support

8.2.2.2 AMR Format Support

8.3 Using MediaControlSkin

8.4 Media Capture

8.5 Well-Behaved MIDlets

8.6 Ring Tones

8.6.1 Download Ring Tones

8.6.2 Ring Tone Formats

9. Working With Mobile Graphics

9.1 Using the Mobile 3D Graphics API

9.1.1 Immediate Mode

9.1.2 Retained Mode

9.1.3 Trading Quality for Speed

9.1.4 Creating Mobile 3D Graphics Content

9.2 Rendering Scalable Vector Graphics Content

9.3 OpenGL® ES Overview

10. Using the PIM and FileConnection APIs

10.1 FileConnection API

10.2 The PIM API

11. Using the Bluetooth and OBEX APIs

11.1 Bluetooth Simulation Environment

11.2 OBEX Over Infrared

11.3 Setting OBEX and Bluetooth Preferences

11.3.1 OBEX Preferences

11.3.2 Bluetooth Internal Properties

11.3.3 Bluetooth System Properties

11.3.4 Bluetooth BCC Properties

12. Using Web Services

13. Using the Location API

13.1 Setting the Emulator's Location at Runtime

13.2 Configuring the Location Provider

13.3 Setting Up Landmarks

14. Using SATSA

14.1 Card Slots in the Emulator

14.2 Using the Java Card Platform Simulator

14.3 Using the Network Monitor with SATSA

14.4 Adjusting Access Control

14.4.1 Specifying PIN Properties

14.4.2 Specifying Application Permissions

14.4.3 Access Control File Example

15. Using SIP

15.1 Understanding the Registrar and Proxy

15.2 SIP Settings

15.3 SIP Traffic in the Network Monitor

15.4 SIP Proxy Server and Registrar

16. Working with the Payment API

16.1 Project Settings for Payment

16.2 Editing Payment Attributes Directly

16.3 Payment Preferences

16.4 Viewing Transaction History

16.5 Monitoring Payments

17. Using the Mobile Internationalization API

17.1 Setting the Emulator's Locale

17.2 Viewing Application Resources

17.3 Working With Locales

17.4 Working With Resource Files

17.5 Working With Resources

A. Application Demonstrations

A.1 Overview

A.2 General Instructions

A.3 Advanced Multimedia Supplements

A.4 Bluetooth Demo

A.5 CHAPIDemo

A.6 CityGuide

A.7 Demos

A.7.1 Colors

A.7.2 Properties

A.7.3 Http

A.7.4 FontTestlet

A.7.5 Stock

A.7.5.1 Working with Settings

A.7.5.2 Stock Tracker

A.7.5.3 What If?

A.7.5.4 Alerts

A.7.6 Tickets

A.7.7 ManyBalls

A.8 Demo3D

A.8.1 Life3D

A.8.2 PogoRoo

A.8.3 retainedmode

A.9 GoSIP

A.10 i18nDemo

A.11 JBricks

A.12 JSR172Demo

A.13 MobileMediaAPI

A.13.1 Simple Tones

A.13.2 Simple Player

A.13.3 Video

A.13.4 Pausing Audio Test

A.13.5 Attributes for MobileMediaAPI

A.14 Network Demo

A.14.1 Socket Demo

A.14.2 Datagram Demo

A.15 ObexDemo

A.16 PDAPDemo

A.16.1 Browsing Files

A.16.2 The PIM API

A.17 SATSADemos

A.17.1 APDUMIDlet

A.17.2 SATMIDlet

A.17.3 CryptoMIDlet

A.17.4 MohairMIDlet

A.18 SATSAJCRMIDemo

A.19 SIPDemo

A.20 SVGContactList

A.21 SVGDemo

A.21.1 SVG Browser

A.21.2 Render SVG Image

A.21.3 Play SVG Animation

A.21.4 Create SVG Image from Scratch

A.21.5 Bouncing Balls

A.21.6 Optimized Menu

A.21.7 Picture Decorator

A.21.8 Location Based Service

A.22 WMADemo

B. Command Line Reference

B.1 Prerequisites

B.2 The Development Cycle

B.2.1 Build

B.2.2 Package

B.2.3 Run

B.2.4 Debugging

B.3 Launching Toolkit GUI Components

B.4 Setting Emulator Preferences

B.5 Using Security Features

B.5.1 Changing the Emulator's Default Protection Domain

B.5.2 Signing MIDlet Suites

B.5.3 Managing Certificates

B.6 Using the Stub Generator

B.6.1 Options

C. Localization

C.1 Locale Setting

C.2 Emulated Locale

C.3 Character Encodings

C.4 Java Technology Compiler Encoding Setting

C.5 Font Support in the Default Emulator

Index