Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Conventions
• Related Documents

1 Getting Started

• 1.1 Quick Start
• 1.2 Tips for Legacy Toolkit Users
• 1.3 Java ME SDK Update Center

2 Platforms

• 2.1 Emulation Platforms
  • 2.1.1 CLDC and MIDP Stack
  • 2.1.2 CDC Stacks
• 2.2 Managing Java Platforms
  • 2.2.1 Java ME Platforms (CLDC and MIDP)
  • 2.2.2 Java SE and CDC Platforms
  • 2.2.3 Create a Platform for Legacy CDC Projects

3 Using Sample Projects

• 3.1 Running a Project
• 3.2 Troubleshooting
• 3.3 Sample Project Overview
• 3.4 Configuring the Web Browser and Proxy Settings
• 3.5 Resolving Reference Problems
• 3.6 Running MIDP and CLDC Sample Projects
  • 3.6.1 Running the AdvancedMultimediaSupplements Sample Project
    • 3.6.1.1 Image Effects
    • 3.6.1.2 Camera
    • 3.6.1.3 Moving Helicopter
    • 3.6.1.4 Music Effects
  • 3.6.2 Running the Demos Sample Project
    • 3.6.2.1 Colors
    • 3.6.2.2 Properties
    • 3.6.2.3 Http
    • 3.6.2.4 FontTestlet
    • 3.6.2.5 Stock
    • 3.6.2.6 Tickets
    • 3.6.2.7 ManyBalls
    • 3.6.2.8 MiniColor
    • 3.6.2.9 Chooser
    • 3.6.2.10 HttpExample
    • 3.6.2.11 HttpView
    • 3.6.2.12 PushExample
  • 3.6.3 Running FPDemo
  • 3.6.4 Running Games
  • 3.6.5 Running Network Demo
    • 3.6.5.1 Socket Demo
    • 3.6.5.2 Datagram Demo
  • 3.6.6 Running PhotoAlbum
  • 3.6.7 Running UIDemo

4 Creating and Editing Projects

• 4.1 Project Types
  • 4.1.1 CLDC Projects
  • 4.1.2 CDC Projects
• 4.2 The Project Wizard
  • 4.2.1 Project Template Page
  • 4.2.2 Name and Location Page
  • 4.2.3 Choose Project (CDC)
  • 4.2.4 Platform Selection (CDC)
  • 4.2.5 WTK MIDP Project Location
  • 4.2.6 CDC Toolkit Project Location
  • 4.2.7 Platform Selection Page (CLDC/MIDP)
  • 4.2.8 Create a CLDC Project
  • 4.2.9 Create a CDC Project
• 4.3 Working With Projects
• 4.4 View Project Files
• 4.5 Create a New MIDlet
  • 4.5.1 Import a Legacy MIDP Project
  • 4.5.2 Import a Legacy CDC Project
• 4.6 Add Files to a Project
• 4.7 Search Project Files

5 Viewing and Editing Project Properties

• 5.1 General Project Properties
• 5.2 Platform Selection
• 5.3 Editing Application Descriptor Properties
  • 5.3.1 CDC Attributes
  • 5.3.2 MIDP Attributes
    • 5.3.2.1 Add an Attribute
    • 5.3.2.2 Edit an Attribute
    • 5.3.2.3 Remove an Attribute
  • 5.3.3 MIDlets
    • 5.3.3.1 Add a MIDlet
    • 5.3.3.2 Edit a MIDlet
    • 5.3.3.3 Remove a MIDlet
    • 5.3.3.4 Change MIDlet Display Order
  • 5.3.4 Push Registry
    • 5.3.4.1 Add a Push Registry Entry
    • 5.3.4.2 Edit a Push Registry Entry
    • 5.3.4.3 Remove a Push Registry Entry
    • 5.3.4.4 Change Push Registry Display Order
  • 5.3.5 API Permissions
    • 5.3.5.1 Adding Permission Requests
• 5.4 Building a Project
  • 5.4.1 Configuring Ant
  • 5.4.2 Compiling
  • 5.4.3 Adding Libraries and Resources
  • 5.4.4 Creating JAR and JAD Files (Packaging)
  • 5.4.5 Obfuscating
  • 5.4.6 Signing
  • 5.4.7 Signing CDC Projects
  • 5.4.8 Exporting a Key
• 5.5 Running Settings
  • 5.5.1 MIDP Project Run Options
  • 5.5.2 CDC Project Run Options

6 Running Projects in the Emulator

• 6.1 Emulating Devices
  • 6.1.1 The Device Manager on Windows
• 6.2 Viewing Device Properties
  • 6.2.1 Platform Properties
  • 6.2.2 Device Information
  • 6.2.3 Device Properties
• 6.3 Setting Device Properties
• 6.4 Opening a Serial Port
• 6.5 Running a Project from the Device Selector
• 6.6 Running Projects Simultaneously on a Single Device
• 6.7 Emulator Features
• 6.8 Emulator Menus
  • 6.8.1 Application
  • 6.8.2 Device
    • 6.8.2.1 Messages
    • 6.8.2.2 Orientation
    • 6.8.2.3 External Events Generator
  • 6.8.3 Edit
  • 6.8.4 View
  • 6.8.5 Help
• 6.9 Adding a Device Instance

7 Searching the WURFL Device Database

• 7.1 WURFL Search for Devices
• 7.2 WURFL Search Filtering

8 Finding Files in the Multiple User Environment

• 8.1 Switching Users
• 8.2 Installation Directories
• 8.3 NetBeans User Directories
• 8.4 Java ME SDK User Directories

9 Profiling Applications

• 9.1 Collecting and Saving Profiler Data in the IDE
• 9.2 Loading a .nps File

10 Network Monitoring

• 10.1 Monitor Network Traffic
• 10.2 Filter or Sort Messages
• 10.3 Save and Load Network Monitor Information
• 10.4 Clear the Message Tree

11 Lightweight UI Toolkit

• 11.1 LWUIT and the Java ME SDK
• 11.2 LWUIT Resource Editor
• 11.3 Add a Different LWUIT Library
• 11.4 LWUIT Demos

12 Security and MIDlet Signing

• 12.1 Security Domains
• 12.2 Setting Security Domains
  • 12.2.1 Specify the Security Domain for an Emulator
  • 12.2.2 Specify the Security Domain for a Project
• 12.3 Signing a Project
  • 12.3.1 Sign a CLDC Project With a Key Pair
  • 12.3.2 Sign a CDC Project
• 12.4 Managing Keystores and Key Pairs
  • 12.4.1 Working With Keystores and Key Pairs
    • 12.4.1.1 Create a Keystore
    • 12.4.1.2 Add an Existing Keystore
    • 12.4.1.3 Create a New Key Pair
    • 12.4.1.4 Remove a Key Pair
    • 12.4.1.5 Import an Existing Key Pair
• 12.5 Managing Root Certificates

13 Command Line Reference

• 13.1 Run the Device Manager
• 13.2 Manage Device Addresses (device-address)
• 13.3 Emulator Command Line Options
  • 13.3.1 MIDlet Options
  • 13.3.2 CDC Options
  • 13.3.3 Debugging and Tracing Options
  • 13.3.4 Command Line Profiling
• 13.4 Build a Project from the Command Line
  • 13.4.1 Check Prerequisites
  • 13.4.2 Compile Class Files
  • 13.4.3 Preverify Class Files
• 13.5 Packaging a MIDLet Suite (JAR and JAD)
• 13.6 Command Line Security Features
  • 13.6.1 Change the Default Protection Domain
  • 13.6.2 Sign MIDlet Suites (jadtool)
  • 13.6.3 Manage Certificates (MEKeyTool)
• 13.7 Generate Stubs (wscompile)

14 Logs

• 14.1 Device Manager Logs
• 14.2 Device Instance Logs

15 JSR Support

• 15.1 JCP APIs

16 JSR 75: PDA Optional Packages

• 16.1 FileConnection API
• 16.2 PIM API
• 16.3 Running PDAPDemo
  • 16.3.1 Browsing Files
  • 16.3.2 The PIM API

17 JSR 82: Bluetooth and OBEX Support

• 17.1 Setting OBEX and Bluetooth Properties
• 17.2 Running the Bluetooth Demo
• 17.3 Running the OBEX Demo

18 JSR 135: Mobile Media API Support

• 18.1 Media Types
  • 18.1.1 Media Capture
• 18.2 MMAPI MIDlet Behavior
• 18.3 Ring Tones
  • 18.3.1 Download Ring Tones
  • 18.3.2 Ring Tone Formats
• 18.4 Running AudioDemo
• 18.5 Running MMAPIDemos
  • 18.5.1 Simple Tones
  • 18.5.2 Simple Player
    • 18.5.2.1 Video
    • 18.5.2.2 Attributes for MobileMediaAPI

19 JSR 172: Web Services Support

• 19.1 Generating Stub Files from WSDL Descriptors
• 19.2 Creating a New Mobile Web Service Client
• 19.3 Run JSR172Demo

20 JSR 177: Smart Card Security (SATSA)

• 20.1 Card Slots in the Emulator
• 20.2 Java Card Platform Simulator (cref)
• 20.3 Adjusting Access Control
  • 20.3.1 Specifying PIN Properties
  • 20.3.2 Specifying Application Permissions
  • 20.3.3 Access Control File Example
• 20.4 Running SATSADemos
  • 20.4.1 APDUMIDlet
  • 20.4.2 SATMIDlet
  • 20.4.3 CryptoMIDlet
  • 20.4.4 MohairMIDlet
  • 20.4.5 Running SATSAJCRMIDemo

21 JSR 179 and 293: Location API Support

• 21.1 Setting the Emulator's Location at Runtime
• 21.2 Running the CityGuide Sample Project
• 21.3 Running the CityGuide2_0 Sample Project

22 JSRs 120 and 205: Wireless Messaging

• 22.1 Using the WMA Console to Send and Receive Messages
  • 22.1.1 Launching the WMA Console
  • 22.1.2 WMA Console Interface
  • 22.1.3 Emulator Phone Numbers
  • 22.1.4 Sending a Text or Binary SMS Message
  • 22.1.5 Sending Text or Binary CBS Messages
  • 22.1.6 Sending MMS Messages
  • 22.1.7 Receiving Messages in the WMA Console
• 22.2 Running WMADemo
  • 22.2.1 WMADemo Push Registry Values
  • 22.2.2 Running WMADemo OTA
  • 22.2.3 Sending SMS Messages From WMA Console to an Emulator and Back
  • 22.2.4 Sending CBS Messages from WMA Console to an Emulator
  • 22.2.5 Sending MMS Messages from WMA Console to an Emulator
• 22.3 Running WMA Tool
  • 22.3.1 smsreceive
  • 22.3.2 cbsreceive
  • 22.3.3 mmsreceive
  • 22.3.4 smssend
  • 22.3.5 cbssend
  • 22.3.6 mmssend

23 JSR 184: Mobile 3D Graphics

• 23.1 Choosing a Graphics Mode
  • 23.1.1 Immediate Mode
  • 23.1.2 Retained Mode
• 23.2 Quality Versus Speed
• 23.3 Content for Mobile 3D Graphics
• 23.4 Running Demo3D Samples
  • 23.4.1 Life3D
  • 23.4.2 RetainedMode
  • 23.4.3 PogoRoo

24 JSR 180: SIP Communications

• 24.1 Understanding the SIP Registrar and Proxy
• 24.2 Running SIPDemo

25 JSR 211: Content Handler API (CHAPI)

• 25.1 Using Content Handlers
• 25.2 Defining Content Handler Properties
• 25.3 Defining Content Handler Actions
• 25.4 Running the CHAPIDemo Content Browser

26 JSR 226: Scalable 2D Vector Graphics

• 26.1 Running SVGDemo
  • 26.1.1 SVG Browser
  • 26.1.2 Render SVG Image
  • 26.1.3 Play SVG Animation
  • 26.1.4 Create SVG Image from Scratch
  • 26.1.5 Bouncing Balls
  • 26.1.6 Optimized Menu
  • 26.1.7 Picture Decorator
  • 26.1.8 Location Based Service
  • 26.1.9 Running SVGContactList

27 JSR 229: Payment API Support

• 27.1 Running the Payment Console
• 27.2 Running JBricks

28 JSR 238: Mobile Internationalization API (MIA)

• 28.1 Setting the Emulator's Locale
• 28.2 Using the Resource Manager
  • 28.2.1 Working With Locales
  • 28.2.2 Working With Resource Files
  • 28.2.3 Working With Resources
• 28.3 Running i18nDemo

29 JSR 239: Java Bindings for Open GL ES

• 29.1 Open GL Overview

30 JSR 256: Mobile Sensor API Support

• 30.1 Creating a Mobile Sensor Project
• 30.2 Using a Mobile Sensor Project
• 30.3 Creating a Sensor Script File
• 30.4 SensorBrowser
• 30.5 Marbles

31 JSR 253: Mobile Telephony API

• 31.1 The MTA Implementation
• 31.2 Running the MtaDemo

32 JSR 257: Contactless Communication API

• 32.1 Using ContactlessDemo
• 32.2 Tag File Formats
• 32.3 Script Format

33 JSR 258: Mobile User Interface Customization API

• 33.1 Running the Customization Sample Project
• 33.2 Revising Sample Project Appearances

Index