Using the Emulator, Emulator Skins | Sun Microsystems J2ME instruction

CHAPTER 4

Using the Emulator

The J2ME Wireless Toolkit emulator simulates a MIDP device on your desktop computer. It is a convenient way to see how your application performs in a MIDP environment and gives you a tight development cycle that is entirely contained on your desktop computer.

The emulator does not represent a specific device, but it provides correct implementations of its supported APIs.

4.1Emulator Skins

A skin is a thin layer on top of the emulator implementation that provides it with a certain appearance, screen characteristics, and input controls. The J2ME Wireless Toolkit comes with skins that represent different kinds of devices.

TABLE 3	Emulator skins

Name		Screen size	Canvas size	Colors	Input

DefaultColorPhon		240 x 320	240 x 289	4096	ITU-T
e
DefaultGrayPhone		180 x 208	180 x 177	4096	ITU-T
MediaControlSkin		180 x 208	180 x 177	4096	ITU-T
QwertyDevice		636 x 235	540 x 204	4096	Qwerty

You can create your own emulator skins if you wish. See the Basic Customization Guide for details.

29

Image 41

Sun Microsystems J2ME manual Using the Emulator, Emulator Skins, Emulator skins

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 Related Documentation PrefaceWho Should Use This Book How This Book Is Organized Preface We Welcome Your Comments Accessing Documentation OnlineTypographic Conventions Quick Start Introduction KToolbar window Tools in the Toolkit Supported Technology Toolkit FeaturesSupported JCP APIs in the J2ME Wireless Toolkit 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 Project directory structure Using Third-Party LibrariesProject Directory Structure Third-Party Libraries for All Projects Configuring KToolbarThird-Party Libraries for One Project Working with Revision Control Systems Setting the Application DirectorySetting the javac Encoding Property 28 J2ME Wireless Toolkit User’s Guide October Emulator skins Using the EmulatorEmulator Skins Using the Emulator DefaultColorPhone emulator skin Keyboard shortcuts Setting Emulator PreferencesNetwork Proxies 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 Saving and Loading Network Monitor Information Network monitor filter settingsSorting Messages 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 Removing a Key Pair Managing CertificatesImporting an Existing 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 Supported Mmapi media formats Using the Mobile Media APISupported Formats and Protocols Well-Behaved MIDlets Using MediaControlSkinMedia Capture JSR 184 Overview Immediate ModeWorking With Mobile 3D Graphics 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 Obex Over Infrared Using the Bluetooth and Obex APIsBluetooth Simulation Environment 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 Descriptions of MMAPI-specific MIDlet attributes ObexDemoAttributes for mmademo 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 Development Cycle Command Line ReferencePrerequisites Preverify options files directories Jar cfm MyApp.jar MANIFEST.MF -C classes . -C res Run=storagename storagenumber Remove=storagename storagenumber all Debugging Emulator Preferences Properties List Toolkit component commandsLaunching Toolkit GUI Components Monitor Enable memory monitor Changing the Emulator’s Default Protection Domain Using Security Features Signing MIDlet Suites Managing Certificates Options Using the Stub GeneratorOptions for the wscompile Command 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