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 with MIDP
  • 2.1.2 IMP-NG
  • 2.1.3 CDC
• 2.2 Managing Java Platforms
  • 2.2.1 Java ME Platforms
  • 2.2.2 Create a Platform for Legacy CDC Projects

3 Using Sample Projects

• 3.1 Creating a Sample Project
• 3.2 Running a Project
• 3.3 Troubleshooting
• 3.4 Sample Project Overview
• 3.5 Configuring the Web Browser and Proxy Settings
• 3.6 Resolving Reference Problems
• 3.7 Running MIDP and CLDC Sample Projects
  • 3.7.1 Running the AdvancedMultimediaSupplements Sample Project
    • 3.7.1.1 Image Effects
    • 3.7.1.2 Music Effects
    • 3.7.1.3 Camera
    • 3.7.1.4 Moving Helicopter
  • 3.7.2 Running the Demos Sample Project
    • 3.7.2.1 Colors
    • 3.7.2.2 Properties
    • 3.7.2.3 Http
    • 3.7.2.4 FontTestlet
    • 3.7.2.5 Stock
    • 3.7.2.6 Tickets
    • 3.7.2.7 ManyBalls
    • 3.7.2.8 MiniColor
    • 3.7.2.9 Chooser
    • 3.7.2.10 HttpExample
    • 3.7.2.11 HttpView
    • 3.7.2.12 PushExample
  • 3.7.3 Running FPDemo
  • 3.7.4 Running Games
  • 3.7.5 Running Network Demo
    • 3.7.5.1 Socket Demo
    • 3.7.5.2 Datagram Demo
  • 3.7.6 Running PhotoAlbum
  • 3.7.7 Running UIDemo
• 3.8 Running IMP-NG Sample Projects
  • 3.8.1 GPIODemo
  • 3.8.2 I2CDemo
  • 3.8.3 NetworkDemoIMPNG
  • 3.8.4 PDAPDemoIMPNG

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 Create a CLDC Project
  • 4.2.2 Create an IMP-NG Project
  • 4.2.3 Create a CDC Project
  • 4.2.4 Import a Legacy MIDP Project
  • 4.2.5 Import a Legacy CDC Project
• 4.3 Working With Projects
• 4.4 View Project Files
• 4.5 Create a New MIDlet
• 4.6 Add Files to a Project
• 4.7 Search Project Files
• 4.8 Debugging CLDC and IMP-NG Projects

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 Enabling 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 Working With Devices

• 6.1 Emulating Devices
  • 6.1.1 The Device Manager on Windows
  • 6.1.2 Starting an Emulator
  • 6.1.3 CLDC Application Management Software Home
• 6.2 Adding a Real Device
• 6.3 Viewing Device Properties
  • 6.3.1 Platform Properties
  • 6.3.2 Device Information
  • 6.3.3 Device Properties
• 6.4 Setting Device Properties
  • 6.4.1 General
  • 6.4.2 Monitor
  • 6.4.3 SATSA
  • 6.4.4 Location Provider #1 and #2
  • 6.4.5 Bluetooth and OBEX
• 6.5 Changing the Maximum Number of Concurrent Applications
• 6.6 Opening a Serial Port
• 6.7 Running a Project from the Device Selector
• 6.8 Running Projects Simultaneously on a Single Device
• 6.9 Emulator Features
• 6.10 Emulator Menus
  • 6.10.1 Application
  • 6.10.2 Device
    • 6.10.2.1 Messages
    • 6.10.2.2 Landmark Stores
    • 6.10.2.3 Orientation
    • 6.10.2.4 External Events Generator
  • 6.10.3 Edit
  • 6.10.4 View
  • 6.10.5 Help
• 6.11 Using the Custom Device Skin Creator
  • 6.11.1 Creating a New Custom Device Skin
  • 6.11.2 Managing Custom Skins

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 Oracle Java ME SDK Directories

9 Profiling Applications

• 9.1 Collecting and Saving Profiler Data in the IDE
• 9.2 Loading a .nps File
• 9.3 Importing a .prof 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 Monitoring Memory

• 11.1 Enabling Tracing
• 11.2 Using the Memory Monitor
• 11.3 Viewing a Session Snapshot

12 Lightweight UI Toolkit

• 12.1 LWUIT and the Java ME SDK
• 12.2 LWUIT Resource Editor
• 12.3 Add a Different LWUIT Library
• 12.4 LWUIT Demos

13 Security and MIDlet Signing

• 13.1 Security Domains
• 13.2 Setting Security Domains
  • 13.2.1 Specify the Security Domain for an Emulator
  • 13.2.2 Specify the Security Domain for a Project
• 13.3 Signing a Project
  • 13.3.1 Sign a CLDC Project With a Key Pair
  • 13.3.2 Sign a CDC Project
• 13.4 Managing Keystores and Key Pairs
  • 13.4.1 Working With Keystores and Key Pairs
    • 13.4.1.1 Create a Keystore
    • 13.4.1.2 Add an Existing Keystore
    • 13.4.1.3 Create a New Key Pair
    • 13.4.1.4 Remove a Key Pair
    • 13.4.1.5 Import an Existing Key Pair
• 13.5 Managing Root Certificates

14 Command Line Reference

• 14.1 Run the Device Manager
• 14.2 Manage Device Addresses (device-address)
• 14.3 Emulator Command Line Options
  • 14.3.1 MIDlet Options
  • 14.3.2 CDC Options
  • 14.3.3 Debugging and Tracing Options
  • 14.3.4 Command Line Profiling
• 14.4 Build a Project from the Command Line
  • 14.4.1 Check Prerequisites
  • 14.4.2 Compile Class Files
  • 14.4.3 Preverify Class Files
• 14.5 Packaging a MIDlet Suite (JAR and JAD)
• 14.6 Command Line Security Features
  • 14.6.1 Change the Default Protection Domain
  • 14.6.2 Sign MIDlet Suites (jadtool)
  • 14.6.3 Manage Certificates (MEKeyTool)
• 14.7 Generate Stubs (wscompile)

15 Logs

• 15.1 Device Manager Logs
• 15.2 Device Instance Logs

16 API Support

• 16.1 JCP APIs
• 16.2 Oracle APIs

17 JSR 75: PDA Optional Packages

• 17.1 FileConnection API
• 17.2 PIM API
• 17.3 Running PDAPDemo
  • 17.3.1 Browsing Files
  • 17.3.2 The PIM API

18 JSR 82: Bluetooth and OBEX Support

• 18.1 Setting OBEX and Bluetooth Properties
• 18.2 Running the Bluetooth Demo
• 18.3 Running the OBEX Demo

19 JSR 135: Mobile Media API Support

• 19.1 Media Types
  • 19.1.1 Media Capture
• 19.2 MMAPI MIDlet Behavior
• 19.3 Ring Tones
  • 19.3.1 Download Ring Tones
  • 19.3.2 Ring Tone Formats
• 19.4 Running AudioDemo
• 19.5 Running MMAPIDemos
  • 19.5.1 Simple Tones
  • 19.5.2 Simple Player
  • 19.5.3 Video
  • 19.5.4 Pausing Audio Test

20 JSR 172: Web Services Support

• 20.1 Generating Stub Files from WSDL Descriptors
• 20.2 Creating a New Mobile Web Service Client
• 20.3 Run JSR172Demo

21 JSR 177: Smart Card Security (SATSA)

• 21.1 Card Slots in the Emulator
• 21.2 Java Card Platform Simulator (cref)
• 21.3 Adjusting Access Control
  • 21.3.1 Specifying PIN Properties
  • 21.3.2 Specifying Application Permissions
  • 21.3.3 Access Control File Example
• 21.4 Running SATSADemos
  • 21.4.1 APDUMIDlet
  • 21.4.2 SATMIDlet
  • 21.4.3 CryptoMIDlet
  • 21.4.4 MohairMIDlet
  • 21.4.5 Running SATSAJCRMIDemo

22 JSR 179: Location API Support

• 22.1 Setting the Emulator's Location at Runtime
• 22.2 Running the CityGuide Sample Project

23 JSR 205: Wireless Messaging

• 23.1 Using the WMA Console to Send and Receive Messages
  • 23.1.1 Launching the WMA Console
  • 23.1.2 WMA Console Interface
  • 23.1.3 Emulator Phone Numbers
  • 23.1.4 Sending a Text or Binary SMS Message
  • 23.1.5 Sending Text or Binary CBS Messages
  • 23.1.6 Sending MMS Messages
  • 23.1.7 Receiving Messages in the WMA Console
• 23.2 Running WMADemo
  • 23.2.1 WMADemo Push Registry Values
  • 23.2.2 Running WMADemo OTA
  • 23.2.3 Sending SMS Messages From WMA Console to an Emulator and Back
  • 23.2.4 Sending CBS Messages from WMA Console to an Emulator
  • 23.2.5 Sending MMS Messages from WMA Console to an Emulator
• 23.3 Running WMA Tool
  • 23.3.1 smsreceive, cbsreceive, and mmsreceive
  • 23.3.2 smssend
  • 23.3.3 cbssend
  • 23.3.4 mmssend

24 JSR 184: Mobile 3D Graphics

• 24.1 Choosing a Graphics Mode
  • 24.1.1 Immediate Mode
  • 24.1.2 Retained Mode
• 24.2 Quality Versus Speed
• 24.3 Content for Mobile 3D Graphics
• 24.4 Running Demo3D Samples
  • 24.4.1 Life3D
  • 24.4.2 RetainedMode
  • 24.4.3 PogoRoo

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.2 Running SVGContactList

27 JSR 239: Java Bindings for Open GL ES

• 27.1 Open GL Overview

28 JSR 256: Mobile Sensor API Support

• 28.1 Creating a Mobile Sensor Project
• 28.2 Using a Mobile Sensor Project
• 28.3 Creating a Sensor Script File
• 28.4 SensorBrowser
• 28.5 Marbles

29 JSR 257: Contactless Communication API

• 29.1 Using ContactlessDemo
• 29.2 Tag File Formats
• 29.3 Script Format

Index