Document Information
Getting Started
Quick Start
Tips for Legacy Toolkit Users
Java ME Platform SDK Features
Emulation Platforms
CLDC and MIDP Stack
CDC Stack
BD-J Stack
JavaFX Platform
Managing Java Platforms
J2SE and CDC Platforms
J2ME Platforms (CLDC and MIDP)
Adding a Java Platform
Selecting a Platform Type
Choose Platform Folder and Name (Java SE and CDC)
Choose Location (JavaSE and CDC)
Create a Platform for Legacy CDC Projects
Choose Java ME MIDP Platform Folders
Choose Custom Java ME MIDP Platform Emulator
General Information
Bootstrap Libraries
Sources & Javadoc
Support for Third-Party Emulators and Real Devices
Automatic Update
Using the Plugins Manager
Available Plugins
Downloaded
Installed Plugins
Plugin Settings
Installing a Plugin Globally
Using Sample Projects
Running a Project
Troubleshooting
Sample Project Overview
Configuring the Web Browser and Proxy Settings
Resolving Reference Problems
Running MIDP and CLDC Sample Projects
Running the Demos Sample Project
Colors
Properties
Http
FontTestlet
Stock
Add Stock Symbols to the Ticker
Change the Update Interval
Remove a Stock
Stock Tracker
What If?
Alerts
Tickets
ManyBalls
MiniColor
Chooser
HttpExample
HttpView
PushExample
Running FPDemo
Running Games
Running Network Demo
Socket Demo
Datagram Demo
Running PhotoAlbum
Running UIDemo
Creating and Editing Projects
About Projects
CLDC Projects
CDC Projects
Creating a CLDC Project
Choose Project
Name and Location
Platform Selection
Specify WTK Project
Creating a CDC Project
Choose Project (CDC)
Platform Selection (CDC)
Specify CDC Toolkit Project
Working With Projects
Viewing Project Files
Creating a New MIDlet
Importing MIDP Projects
Importing CDC Projects
Adding Files to a Project
Find in Files
Viewing and Editing Project Properties
Viewing General Project Properties
Selecting a Platform
Editing Application Descriptor Properties
CDC Attributes
MIDP Attributes
Adding an Attribute
Editing an Attribute
Removing an Attribute
MIDlets
Adding a MIDlet
Editing a MIDlet
Removing a MIDLet
Changing MIDlet Display Order
Push Registry
Adding a Push Registry Entry
Remove a Push Registry Entry
Change Push Registry Display Order
API Permissions
Building a Project
Configuring Ant
Compiling
Adding Libraries and Resources
Creating JAR and JAD Files (Packaging)
Obfuscating
Signing
Exporting a Key
Running Settings
Running a MIDP Project
Running a CDC Project
Running Projects in the Emulator
Understanding the Emulator
Viewing Device Properties
Platform Properties
Device Information
Device Properties
Setting Device Properties
Running a Project from the Device Selector
Running Projects Simultaneously on a Single Device
Emulator Options
Adding a Device Instance
Searching the WURFL Device Database
Searching for Devices
Filtering the WURFL Search
Finding Files in the Multiple User Environment
Switching Users
Installation Directories
User Directories
/javame-sdk
/javame-sdk/3.0/work
/javame-sdk/toolbar/3.0
/JavaMESDKProjects
Profiling Applications
Saving Profiler Data
Loading Profiler Data
Viewing Profiler Data
Saving Customized Snapshots and Images
Loading a Customized Snapshot
Monitoring Network Traffic
Using the Network Monitor
Filtering Messages
Sorting Messages
Saving and Loading Network Monitor Information
Clearing the Message Tree
Lightweight UI Toolkit
Adding the LWUIT Library
Using the LWUIT Resource Manager
Security and MIDlet Signing
Security Domains
Setting Security Domains
Specifying the Security Domain for an Emulator
Specifying the Security Domain for a Project
Signing a Project
Managing Keystores and Key Pairs
Working With Keystores and Key Pairs
Creating a Keystore
Adding an Existing Keystore
Creating a New Key Pair
Removing a Key Pair
Importing an Existing Key Pair
Managing Root Certificates
BD-J Support
Creating a Stubs for BD-J Platform Project
Compiling, Deploying, and Running a Stubs for BD-J Platform Project
CLDC Emulation on a Windows Mobile Device
CLDC Emulator Installation for a Device Running Windows Mobile
Testing On-device Debugging
Installing CLDC Emulation on a Windows Mobile Emulator
CLDC Installation for Windows Mobile
On-device Debugging
On-device Debugging Procedure
Attach a Command Line Debugger
Attach a Graphical Debugger
Sample CLDC Debugging Session
Command Line Reference
Launching the SDK
Running the Device Manager
Managing Device Addresses (device-address)
Running the Emulator From the Command Line
MIDlet Options
CDC Options
Debugging and Tracing Options
Building a Project from the Command Line
Checking Prerequisites
Compiling Class Files
Preverifying Class Files
Packaging a MIDLet Suite (JAR and JAD)
Command Line Security Features
Changing the Emulator's Default Protection Domain
Signing MIDlet Suites (
jadtool.exe
)
Managing Certificates (MEKeyTool)
Generating Stubs (wscompile)
Running the Payment Console From the Command Line
Virtual Machine Memory Profiler (Java Heap Memory Observe Tool)
Running the Java Heap Memory Observe Tool
Viewing the Heap Snapshot
Running WMA Tool
smsreceive
cbsreceive
mmsreceive
smssend
cbssend
mmssend
Logs
Java ME Platform SDK GUI Logs
Device Manager Logs
Device Instance Logs
JSR Support
JCP APIs
JSR 75: PDA Optional Packages
FileConnection API
PIM API
Running PDAPDemo
Browsing Files
The PIM API
JSR 82: Bluetooth and OBEX Support
Bluetooth Simulation Environment
OBEX Over Infrared
Setting Bluetooth and OBEX Preferences
OBEX Preferences
Bluetooth Internal Properties
Bluetooth System Properties
Bluetooth BCC Properties
Running the Bluetooth Demo
JSR 135: Mobile Media API Support
Media Types
Adaptive Multi-Rate (AMR) Content
Media Capture
MMAPI MIDlet Behavior
Ring Tones
Download Ring Tones
Ring Tone Formats
Running the MMAPI Sample Project
Running AudioDemo
Running MMAPIDemos
Simple Tones
Simple Player
Video
Attributes for MobileMediaAPI
Running the Multimedia Sample Project
JSR 172: Web Services Support
Generating Stub Files from WSDL Descriptors
Creating a New Mobile Web Service Client
Running JSR172Demo
JSR 177: Smart Card Security (SATSA)
Card Slots in the Emulator
Java Card Platform Simulator (
cref
)
Adjusting Access Control
Specifying PIN Properties
Specifying Application Permissions
Access Control File Example
Running SATSADemos
APDUMIDlet
SATMIDlet
CryptoMIDlet
MohairMIDlet
Running SATSAJCRMIDemo
JSR 179: Location API Support
Setting the Emulator's Location at Runtime
Running the CityGuide Sample Project
JSRs 184, 226, and 239: Graphics Capabilities
Mobile 3D Graphics (JSR 184)
Choosing a Graphics Mode
Immediate Mode
Retained Mode
Quality Versus Speed
Content for Mobile 3D Graphics
Running Demo3D Samples
Life3D
retainedmode
PogoRoo
Java Bindings for OpenGL ES (JSR 239)
Scalable 2D Vector Graphics (JSR 226)
Running SVGDemo
SVG Browser
Render SVG Image
Play SVG Animation
Create SVG Image from Scratch
Bouncing Balls
Optimized Menu
Picture Decorator
Location Based Service
PlaySVGImageDemo
Running SVGContactList
JSR 205: Wireless Messaging API (WMA) Support
Using the WMA Console to Send and Receive Messages
Launching the WMA Console
WMA Console Interface
Emulator Phone Numbers
Sending a Text SMS Message
Sending a Binary SMS Message
Sending Text or Binary CBS Messages
Sending MMS Messages
Receiving Messages in the WMA Console
Running WMADemo
JSR 211: Content Handler API (CHAPI)
Using Content Handlers
Defining Content Handler Properties
Defining Content Handler Actions
Running the CHAPIDemo Content Browser
JSR 238: Mobile Internationalization API (MIA)
Setting the Emulator's Locale
Using the Resource Manager
Working With Locales
Working With Resource Files
Working With Resources
Running i18nDemo
JSR 229: Payment API Support
Running the Payment Console
Running JBricks
JSR 256: Mobile Sensor API Support
Creating a Mobile Sensor Project
Using a Mobile Sensor Project
Creating a Sensor Script File
Running the Sensors Sample Project
SensorBrowser
Marbles
Index
sun.com
Java Platform Micro Edition Software Development Kit
Version 3.0
April 2009
This helpset describes how to use the Java ME Platform SDK version 3.0.