Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Conventions
• Related Documents

1 Before You Begin

• 1.1 Installing the Java SE Platform
  • 1.1.1 Setting and Verifying Your Java SE PATH
• 1.2 Installing the Java ME SDK Platform
• 1.3 Installing and Starting the Eclipse IDE

2 Installing Plugins and Configuring Eclipse

• 2.1 Installing the Oracle Java ME SDK Eclipse Plugin
  • 2.1.1 Installing Plugins on Eclipse Indigo 3.7
  • 2.1.2 Installing Plugins on Eclipse Juno 4.2
• 2.2 Configuring Eclipse
• 2.3 Verify Your Installation
  • 2.3.1 Adding Devices Manually
• 2.4 Quick Start

3 Platforms

• 3.1 Emulation Platforms
  • 3.1.1 CLDC with MIDP
  • 3.1.2 IMP-NG

4 Using Sample Projects

• 4.1 Creating a Sample Project
• 4.2 Running a Project
• 4.3 Troubleshooting
• 4.4 Sample Project Overview
• 4.5 Configuring the Web Browser and Proxy Settings
• 4.6 Running MIDP and CLDC Sample Projects
  • 4.6.1 Running the AdvancedMultimediaSupplements Sample Project
    • 4.6.1.1 Image Effects
    • 4.6.1.2 Music Effects
    • 4.6.1.3 Camera
    • 4.6.1.4 Moving Helicopter
  • 4.6.2 Running the Demos Sample Project
    • 4.6.2.1 Colors
    • 4.6.2.2 Properties
    • 4.6.2.3 Http
    • 4.6.2.4 FontTestlet
    • 4.6.2.5 Stock
    • 4.6.2.6 Tickets
    • 4.6.2.7 ManyBalls
    • 4.6.2.8 MiniColor
    • 4.6.2.9 Chooser
    • 4.6.2.10 HttpExample
    • 4.6.2.11 HttpView
    • 4.6.2.12 PushExample
  • 4.6.3 Running FPDemo
  • 4.6.4 Running Games
  • 4.6.5 Running Network Demo
    • 4.6.5.1 Socket Demo
    • 4.6.5.2 Datagram Demo
  • 4.6.6 Running PhotoAlbum
  • 4.6.7 Running UIDemo
• 4.7 Running IMP-NG Sample Projects
  • 4.7.1 Running the GPIODemo
    • 4.7.1.1 Running the GPIODemo on the Emulator
    • 4.7.1.2 Running the GPIODemo on the Reference Board
  • 4.7.2 Running the I2CDemo
  • 4.7.3 Running the NetworkDemoIMPNG
    • 4.7.3.1 Running NetworkDemoIMPNG on the Emulator
    • 4.7.3.2 Running NetworkDemoIMPNG on the Reference Board
  • 4.7.4 Running the PDAPDemoIMPNG
    • 4.7.4.1 Running the PDAPDemoIMPNG on the Emulator
    • 4.7.4.2 Running PDAPDemoIMPNG on the Reference Board
  • 4.7.5 Running the Pulse Counter (Data Collection) Demo
  • 4.7.6 Configuring a Pulse Counter
  • 4.7.7 Running the Light Tracker Demo
  • 4.7.8 Running the System Controller Demo

5 Viewing and Editing Project Properties

• 5.1 Projects
• 5.2 Project Properties
• 5.3 Platform Selection
• 5.4 Editing Application Descriptor Properties
• 5.5 Building a Project
  • 5.5.1 Compiling
  • 5.5.2 Adding Libraries and Resources
  • 5.5.3 Creating JAR and JAD Files (Packaging)
  • 5.5.4 Obfuscating
  • 5.5.5 Signing
• 5.6 Running and Debugging Settings
  • 5.6.1 MIDP Project Run Options
  • 5.6.2 Debugging Options

6 Working With Devices

• 6.1 Emulators
  • 6.1.1 The Device Manager on Windows
  • 6.1.2 Starting an Emulator
  • 6.1.3 CLDC Application Management System
• 6.2 Adding an External 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 Opening a Serial Port
• 6.6 Connecting to a UART Device
• 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 Orientation
  • 6.10.3 Edit
  • 6.10.4 Tools
    • 6.10.4.1 External Events Generator
  • 6.10.5 View
  • 6.10.6 Help
• 6.11 Using the Custom Device Editor
  • 6.11.1 Creating a Custom Device
  • 6.11.2 Managing Custom Device
  • 6.11.3 IMP-NG Device Options
    • 6.11.3.1 General Purpose Input Output (GPIO)
    • 6.11.3.2 Inter-Integrated Circuit (I2C) and Serial Peripheral Interface (SPI)
    • 6.11.3.3 Memory-Mapped I/O (MMIO)

7 Finding Files in the Multiple User Environment

• 7.1 Switching Users
• 7.2 Installation Directories
• 7.3 Eclipse User Directories
• 7.4 Oracle Java ME SDK Directories

8 Profiling Applications

• 8.1 Collecting and Saving Profiler Data in the IDE
• 8.2 Loading a .prf File

9 Network Monitoring

• 9.1 Monitor Network Traffic
• 9.2 Filter or Sort Messages
• 9.3 Save and Load Network Monitor Information

10 Monitoring Memory

• 10.1 Enabling Tracing
• 10.2 Using the Memory Monitor
• 10.3 Saving and Viewing a Session Snapshot

11 Security and MIDlet Signing

• 11.1 Security Domains
• 11.2 Setting Security Domains
  • 11.2.1 Specify the Security Domain for an Emulator
  • 11.2.2 Specify the Security Domain for a Project
• 11.3 Signing a Project With a Key Pair
• 11.4 Managing Keystores and Key Pairs
• 11.5 Command Line Samples

12 Command Line Reference

• 12.1 Run the Device Manager
• 12.2 Manage Device Addresses (device-address)
• 12.3 Emulator Command Line Options
  • 12.3.1 MIDlet Options
  • 12.3.2 Debugging and Tracing Options
  • 12.3.3 Command Line Profiling
• 12.4 Build a Project from the Command Line
  • 12.4.1 Check Prerequisites
  • 12.4.2 Compile Class Files
  • 12.4.3 Preverify Class Files
• 12.5 Packaging a MIDlet Suite (JAR and JAD)
• 12.6 Command Line Security Features
  • 12.6.1 Change the Default Protection Domain
  • 12.6.2 Sign MIDlet Suites (jadtool)
  • 12.6.3 Manage Certificates (MEKeyTool)
• 12.7 Generate Stubs (wscompile)

13 Logs

• 13.1 Device Manager Logs
• 13.2 Device Instance Logs

14 API Support

• 14.1 JCP APIs
• 14.2 Oracle APIs

15 JSR 75: PDA Optional Packages

• 15.1 FileConnection API
• 15.2 PIM API
• 15.3 Running PDAPDemo
  • 15.3.1 Browsing Files
  • 15.3.2 The PIM API

16 JSR 82: Bluetooth and OBEX Support

• 16.1 Setting OBEX and Bluetooth Properties
• 16.2 Running the Bluetooth Demo
• 16.3 Running the OBEX Demo

17 JSR 135: Mobile Media API Support

• 17.1 Media Types
  • 17.1.1 Media Capture
• 17.2 MMAPI MIDlet Behavior
• 17.3 Ring Tones
  • 17.3.1 Download Ring Tones
  • 17.3.2 Ring Tone Formats
• 17.4 Running AudioDemo
• 17.5 Running MMAPIDemos
  • 17.5.1 Simple Tones
  • 17.5.2 Simple Player
  • 17.5.3 Video
  • 17.5.4 Pausing Audio Test

18 JSR 177: Smart Card Security (SATSA)

• 18.1 Card Slots in the Emulator
• 18.2 Adjusting Access Control
  • 18.2.1 Specifying PIN Properties
  • 18.2.2 Specifying Application Permissions
  • 18.2.3 Access Control File Example
  • 18.2.4 Running the SATSA Demo

19 JSR 179: Location API Support

• 19.1 Setting the Emulator's Location at Runtime
• 19.2 Running the CityGuide Sample Project

20 JSR 205: Wireless Messaging

• 20.1 Using the WMA Console to Send and Receive Messages
  • 20.1.1 Launching the WMA Console
  • 20.1.2 WMA Console Interface
  • 20.1.3 Emulator Phone Numbers
  • 20.1.4 Sending a Text or Binary SMS Message
  • 20.1.5 Sending Text or Binary CBS Messages
  • 20.1.6 Sending MMS Messages
  • 20.1.7 Receiving Messages in the WMA Console
• 20.2 Running WMADemo
  • 20.2.1 WMADemo Push Registry Values
  • 20.2.2 Sending SMS Messages From WMA Console to an Emulator and Back
  • 20.2.3 Sending MMS Messages from WMA Console to an Emulator
• 20.3 Running WMA Tool
  • 20.3.1 smsreceive, cbsreceive, and mmsreceive
  • 20.3.2 smssend
  • 20.3.3 cbssend
  • 20.3.4 mmssend

21 JSR 184: Mobile 3D Graphics

• 21.1 Choosing a Graphics Mode
  • 21.1.1 Immediate Mode
  • 21.1.2 Retained Mode
• 21.2 Quality Versus Speed
• 21.3 Content for Mobile 3D Graphics
• 21.4 Running Demo3D Samples
  • 21.4.1 Life3D
  • 21.4.2 RetainedMode
  • 21.4.3 PogoRoo

22 JSR 211: Content Handler API (CHAPI)

• 22.1 Using Content Handlers
• 22.2 Running the CHAPIDemo Content Browser

23 JSR 226: Scalable 2D Vector Graphics

• 23.1 Running SVGDemo
  • 23.1.1 SVG Browser
  • 23.1.2 Render SVG Image
  • 23.1.3 Play SVG Animation
  • 23.1.4 Create SVG Image from Scratch
  • 23.1.5 Bouncing Balls
  • 23.1.6 Optimized Menu
  • 23.1.7 Picture Decorator
  • 23.1.8 Location Based Service
• 23.2 Running SVGContactList

24 JSR 239: Java Bindings for Open GL ES

• 24.1 Open GL Overview

25 JSR 256: Mobile Sensor API Support

• 25.1 Creating a Mobile Sensor Project
• 25.2 Using a Mobile Sensor Project
• 25.3 Creating a Sensor Script File
• 25.4 SensorBrowser
• 25.5 Marbles

26 JSR 257: Contactless Communication API

• 26.1 Using ContactlessDemo
• 26.2 Tag File Formats
• 26.3 Script Format

A Installation and Runtime Security Guidelines

• A.1 Maintaining Optimum Network Security

Index