Skip Headers
Oracle® Java Micro Edition Software Development Kit Developer's Guide
Release 3.4 for NetBeans on Windows
E24265-06
Index
Next
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 Oracle Java ME SDK Platform
1.3
Installing and the Starting the NetBeans IDE
2
Installing Plugins
2.1
Downloading Oracle Java ME SDK Plugins
2.2
Installing Oracle Java ME SDK Plugins
2.2.1
Installing Plugins Using the Update Center
2.2.2
Installing NetBeans Plugins Manually
2.3
Verifying Your Installation
2.4
Quick Start
3
Platforms
3.1
Emulation Platforms
3.1.1
CLDC with MIDP
3.1.2
IMP-NG
3.1.3
CDC
3.2
Managing Java Platforms
3.2.1
Java ME Platforms
3.2.2
Create a Platform for Legacy CDC Projects
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
Resolving Reference Problems
4.7
Running MIDP and CLDC Sample Projects
4.7.1
Running the AdvancedMultimediaSupplements Sample Project
4.7.1.1
Image Effects
4.7.1.2
Music Effects
4.7.1.3
Camera
4.7.1.4
Moving Helicopter
4.7.2
Running the Demos Sample Project
4.7.2.1
Colors
4.7.2.2
Properties
4.7.2.3
Http
4.7.2.4
FontTestlet
4.7.2.5
Stock
4.7.2.6
Tickets
4.7.2.7
ManyBalls
4.7.2.8
MiniColor
4.7.2.9
Chooser
4.7.2.10
HttpExample
4.7.2.11
HttpView
4.7.2.12
PushExample
4.7.3
Running FPDemo
4.7.4
Running Games
4.7.5
Running Network Demo
4.7.5.1
Socket Demo
4.7.5.2
Datagram Demo
4.7.6
Running PhotoAlbum
4.7.7
Running UIDemo
4.8
Running IMP-NG Sample Projects
4.8.1
Running the GPIODemo
4.8.1.1
Running the GPIODemo on the Emulator
4.8.1.2
Running the GPIODemo on the Reference Board
4.8.2
Running the I2CDemo
4.8.3
Running the NetworkDemoIMPNG
4.8.3.1
Running NetworkDemoIMPNG on the Emulator
4.8.3.2
Running NetworkDemoIMPNG on the Reference Board
4.8.4
Running the PDAPDemoIMPNG
4.8.4.1
Running the PDAPDemoIMPNG on the Emulator
4.8.4.2
Running PDAPDemoIMPNG on the Reference Board
4.8.5
Running the Pulse Counter (Data Collection) Demo
4.8.6
Configuring a Pulse Counter
4.8.7
Running the Light Tracker Demo
4.8.8
Running the System Controller Demo
5
Creating and Editing Projects
5.1
Project Types
5.1.1
MIDP Projects
5.1.2
CDC Projects
5.2
The Project Wizard
5.2.1
Create a MIDP Project
5.2.2
Create an IMP-NG Project
5.2.3
Create a CDC Project
5.2.4
Import a Legacy MIDP Project
5.2.5
Import a Legacy CDC Project
5.3
Working With Projects
5.4
View Project Files
5.5
Create a New MIDlet
5.6
Add Files to a Project
5.7
Search Project Files
5.8
Debugging MIDP and IMP-NG Projects
6
Viewing and Editing Project Properties
6.1
General Project Properties
6.2
Platform Selection
6.3
Editing Application Descriptor Properties
6.3.1
CDC Attributes
6.3.2
MIDP Attributes
6.3.2.1
Add an Attribute
6.3.2.2
Edit an Attribute
6.3.2.3
Remove an Attribute
6.3.3
MIDlets
6.3.3.1
Add a MIDlet
6.3.3.2
Edit a MIDlet
6.3.3.3
Remove a MIDlet
6.3.3.4
Change MIDlet Display Order
6.3.4
Push Registry
6.3.4.1
Add a Push Registry Entry
6.3.4.2
Enabling a Push Registry Entry
6.3.4.3
Remove a Push Registry Entry
6.3.4.4
Change Push Registry Display Order
6.3.5
API Permissions
6.3.5.1
Adding Permission Requests
6.4
Building a Project
6.4.1
Configuring Ant
6.4.2
Compiling
6.4.3
Adding Libraries and Resources
6.4.4
Creating JAR and JAD Files (Packaging)
6.4.5
Obfuscating
6.4.6
Signing
6.4.7
Signing CDC Projects
6.4.8
Exporting a Key
6.5
Running Settings
6.5.1
MIDP Project Run Options
6.5.2
CDC Project Run Options
7
Working With Devices
7.1
The Device Manager on Windows
7.1.1
Adding an External Device
7.2
Starting and Running Emulators
7.2.1
Starting an Emulator
7.3
The IMP-NG Emulator
7.3.1
The External Events Generator
7.3.2
IMP-NG Device Options
7.4
The Qualcomm IoE Emulator
7.4.1
The External Events Generator
7.4.1.1
The Serial Peripheral Interface (SPI) Tab
7.4.1.2
The Inter-Integrated Circuit (I2C) Tab
7.5
The CLDC Mobile Emulator
7.5.1
CLDC Application Management System
7.5.2
Mobile Emulator Menus
7.5.3
Running Projects Simultaneously on a Single Device
7.6
Emulator Menu Settings
7.6.1
The Application Menu
7.6.2
The Device Menu
7.6.2.1
Messages
7.6.2.2
Orientation
7.6.3
The Edit Menu
7.6.4
The Tools Menu
7.6.5
The View Menu
7.6.6
The Help Menu
7.7
Using the Device Selector
7.7.1
Viewing Device Properties
7.7.1.1
Platform Properties
7.7.1.2
Device Information
7.7.1.3
Device Properties
7.7.2
Setting Device Properties
7.7.2.1
General Device Properties
7.7.2.2
Monitor
7.7.2.3
IMP-NG Device Properties
7.7.2.4
Location Provider #1 and #2
7.7.2.5
SATSA
7.7.2.6
Bluetooth and OBEX
7.7.3
Running a Project from the Device Selector
7.8
Using the Custom Device Editor
7.8.1
Creating a Custom Device
7.8.2
Managing Custom Devices
7.9
Making Device Connections
7.9.1
Connecting to a UART Device
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
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
API Support
15.1
JCP APIs
15.2
Oracle 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.3
Video
18.5.4
Pausing Audio Test
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
Adjusting Access Control
20.2.1
Specifying PIN Properties
20.2.2
Specifying Application Permissions
20.2.3
Access Control File Example
20.2.4
Running the SATSA Demo
21
JSR 179: Location API Support
21.1
Setting the Emulator's Location at Runtime
21.2
Running the CityGuide Sample Project
22
JSR 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, cbsreceive, and mmsreceive
22.3.2
smssend
22.3.3
cbssend
22.3.4
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 211: Content Handler API (CHAPI)
24.1
Using Content Handlers
24.2
Defining Content Handler Properties
24.3
Defining Content Handler Actions
24.4
Running the CHAPIDemo Content Browser
25
JSR 226: Scalable 2D Vector Graphics
25.1
Running SVGDemo
25.1.1
SVG Browser
25.1.2
Render SVG Image
25.1.3
Play SVG Animation
25.1.4
Create SVG Image from Scratch
25.1.5
Bouncing Balls
25.1.6
Optimized Menu
25.1.7
Picture Decorator
25.1.8
Location Based Service
25.2
Running SVGContactList
26
JSR 239: Java Bindings for Open GL ES
26.1
Open GL Overview
27
JSR 256: Mobile Sensor API Support
27.1
Creating a Mobile Sensor Project
27.2
Using a Mobile Sensor Project
27.3
Creating a Sensor Script File
27.4
SensorBrowser
27.5
Marbles
28
JSR 257: Contactless Communication API
28.1
Using ContactlessDemo
28.2
Tag File Formats
28.3
Script Format
A
Installation and Runtime Security Guidelines
A.1
Maintaining Optimum Network Security
B
Tips for Legacy Toolkit Users
Index