Preface, Who Should Use This Book | Sun Microsystems J2ME guide

Preface

This document describes how to work with the J2ME Wireless Toolkit.

Who Should Use This Book

This guide is intended for developers creating Mobile Information Device Profile (MIDP) applications with the J2ME Wireless Toolkit. You should already understand how to use, the Mobile Information Device Profile (MIDP), and the Connected Limited Device Configuration (CLDC).

If you need help getting started with Java programming, try the New to Java Center:

http://java.sun.com/learning/new2java/

For a quick start with MIDP programming, read Learning Path: Getting Started with MIDP 2.0:

http://developers.sun.com/techtopics/mobility/learn/midp/

midp20/

Related Documentation

This book is not a tutorial in MIDP programming, nor is it a tutorial in programming any of the additional APIs that are supported by the toolkit. This section lists related specifications. Although specifications are definitive, they are not always the most accessible kind of information. For a variety of developer- centered articles, try Sun’s mobility web site:

Preface ix

Image 9

Sun Microsystems J2ME manual Preface, Who Should Use This Book, Related Documentation

Contents

User’s Guide Please Recycle Contents Using the Emulator Security and MIDlet Signing Using the PIM and FileConnection APIs Command Line Reference 103 Index Preface Who Should Use This BookRelated Documentation How This Book Is Organized Preface Accessing Documentation Online Typographic ConventionsWe Welcome Your Comments Quick Start Introduction KToolbar window Tools in the Toolkit Toolkit Features Supported JCP APIs in the J2ME Wireless ToolkitSupported Technology Mmapi About Projects Developing MIDlet Suites Creating a new project Edit Source Code Simple Development Cycle Build Messages about building 3 Run List of project MIDlets Package Full Development Cycle Emulator AMS welcome screen Install URL prompt Application menu, again Launching the installed application Using an Obfuscator Obfuscate.script.name scriptfile Deploying Applications on a Web Server Using a Debugger From the command line, run Selecting APIs Working With Projects Project settings window Changing MIDlet Suite Attributes Editing MIDlet suite attributes List of MIDlets in a project Manipulating MIDlets Project push registry settings Using the Push Registry Using Third-Party Libraries Project Directory StructureProject directory structure Configuring KToolbar Third-Party Libraries for One ProjectThird-Party Libraries for All Projects Setting the Application Directory Setting the javac Encoding PropertyWorking with Revision Control Systems 28 J2ME Wireless Toolkit User’s Guide October Using the Emulator Emulator SkinsEmulator skins Using the Emulator DefaultColorPhone emulator skin Setting Emulator Preferences Network ProxiesKeyboard shortcuts Heap Size Storage and Cleaning Choose Edit Preferences... and click on the Performance tab Adjusting Emulator Performance Adjusting the emulator’s performance Pausing and Resuming Running the Emulator Solo Using Third Party Emulators Emulators 38 J2ME Wireless Toolkit User’s Guide October Monitoring Applications Using the Profiler Turning on the profiler Execution Time and Number of Calls Call Graph Saving and Loading Profiler Information Using the Memory Monitor You’ll see a table with the following columns Saving and Loading Memory Monitor Information Using the Network Monitor Network monitor Filtering Messages Network monitor filter settings Sorting MessagesSaving and Loading Network Monitor Information Clearing the Message Tree 48 J2ME Wireless Toolkit User’s Guide October Permissions Security and MIDlet Signing MIDlet suite permissions Protection Domains Signing a MIDlet Suite Creating a New Key Pair Managing Keys Creating a new key pair Getting Real Keys Managing Certificates Importing an Existing Key PairRemoving a Key Pair Certificate manager Importing Certificates Removing Certificates Setting Emulator Phone Numbers Using the Wireless Messaging API Simulating an Unreliable Network Setting WMA preferences Sending a Text SMS Message Sending Messages With the WMA Console Sending a text message Sending a Binary SMS Message Sending a binary message Sending Text or Binary CBS Messages Sending CBS messages Sending MMS Messages Adding recipients for an MMS message Receiving Messages in the WMA Console Using the Network Monitor with WMA Using the Mobile Media API Supported Formats and ProtocolsSupported Mmapi media formats Using MediaControlSkin Media CaptureWell-Behaved MIDlets Immediate Mode Working With Mobile 3D GraphicsJSR 184 Overview Trading Quality for Speed Retained Mode Creating Mobile 3D Graphics Content 70 J2ME Wireless Toolkit User’s Guide October FileConnection API Using the PIM and FileConnection APIs Managing filesystem roots PIM API Using the Bluetooth and Obex APIs Bluetooth Simulation EnvironmentObex Over Infrared Obex Preferences Setting Obex and Bluetooth Preferences Bluetooth System Properties Bluetooth Discovery TimeoutBluetooth BCC Properties BCC properties 76 J2ME Wireless Toolkit User’s Guide October Web services stub generator Using Web Services 78 J2ME Wireless Toolkit User’s Guide October Overview Application Demonstrations Application demonstrations \WTK22\apps\WMADemo\src\example\sms\SMSSend.java KToolbar General Instructions Opening a demonstration application project BluetoothDemo Running the Bluetooth Demo server Life3D Demo3D Controls for Life3D PogoRoo Bouncing kangaroo Retainedmode Mmademo JSR172Demo Simple Player Simple Tones Player commands Video PausingAudioTest ObexDemo Attributes for mmademoDescriptions of MMAPI-specific MIDlet attributes Waiting for an Obex connection Prompting to accept a connection Browsing Files PDAPDemo Contents of the root1 directory Choosing a list type PIM API To actually save the list item, choose Commit from the menu Saving an item WMADemo Sending a text message Push registry springs to life Addressing an MMS message WMADemo receives the image Command Line Reference PrerequisitesDevelopment Cycle Preverify options files directories Jar cfm MyApp.jar MANIFEST.MF -C classes . -C res Run=storagename storagenumber Remove=storagename storagenumber all Debugging Toolkit component commands Launching Toolkit GUI ComponentsEmulator Preferences Properties List Monitor Enable memory monitor Changing the Emulator’s Default Protection Domain Using Security Features Signing MIDlet Suites Managing Certificates Using the Stub Generator Options for the wscompile CommandOptions Example Command Supported Features -f for wscompile Internationalization Locale Setting Character Encodings Emulated Locale Java Compiler Encoding Setting Font Support in the Default Emulator 118 J2ME Wireless Toolkit User’s Guide October Index Ktools.properties, 27 ktools.properties ﬁle Index 122 J2ME Wireless Toolkit User’s Guide October