Launching Toolkit GUI Components | Sun Microsystems J2ME manual

B.3 Launching Toolkit GUI Components

The components of the J2ME Wireless Toolkit can all be launched from the command line. Each component is in the toolkit’s bin directory.

TABLE 12 Toolkit component commands

Command	Description

DefaultDevice	Pops up a dialog that allows you to choose the default emulator skin
ktoolbar	Launches KToolbar
prefs	Launches the toolkit preferences
utils	Launches the toolkit utilities window

B.4 Setting Emulator Preferences

You can change the emulator preferences from the command line by using the -

Xprefs option for the emulator command. The format is as follows:

-Xprefs:<filename>

The filename you provide should be the full path name of a property file whose values override the values in the preferences dialog box. The property file can contain the following properties:

TABLE 13 Emulator Preferences Properties List

Property Name	Property Description and Legal Values

http.version	Network Configuration > HTTP Version
	Value: HTTP/1.1 HTTP/1.0
http.proxyHost	Network Configuration > HTTP Address
	Value: hostname
http.proxyPort	Network Configuration > HTTP Port
	Value: integer
https.proxyHost	Network Configuration > HTTPS Address
	Value: hostname
https.proxyPort	Network Configuration > HTTPS Port
	Value: integer

108 J2ME Wireless Toolkit User’s Guide • October 2004

Image 120

Sun Microsystems J2ME Launching Toolkit GUI Components, Toolkit component commands, Emulator Preferences Properties List

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 Introduction Quick Start Tools in the Toolkit KToolbar window Toolkit Features Supported JCP APIs in the J2ME Wireless ToolkitSupported Technology Mmapi Developing MIDlet Suites About Projects Creating a new project Simple Development Cycle Edit Source Code Build 3 Run Messages about building List of project MIDlets Full Development Cycle Package Install Emulator AMS welcome screen URL prompt Application menu, again Using an Obfuscator Launching the installed application Obfuscate.script.name scriptfile Using a Debugger Deploying Applications on a Web Server From the command line, run Working With Projects Selecting APIs Project settings window Changing MIDlet Suite Attributes Editing MIDlet suite attributes Manipulating MIDlets List of MIDlets in a project Using the Push Registry Project push registry settings 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 Storage and Cleaning Heap Size Adjusting Emulator Performance Choose Edit Preferences... and click on the Performance tab Pausing and Resuming Adjusting the emulator’s performance Using Third Party Emulators Running the Emulator Solo Emulators 38 J2ME Wireless Toolkit User’s Guide October Using the Profiler Monitoring Applications Turning on the profiler Call Graph Execution Time and Number of Calls Using the Memory Monitor Saving and Loading Profiler Information You’ll see a table with the following columns Using the Network Monitor Saving and Loading Memory Monitor Information Filtering Messages Network monitor Network monitor filter settings Sorting MessagesSaving and Loading Network Monitor Information Clearing the Message Tree 48 J2ME Wireless Toolkit User’s Guide October Security and MIDlet Signing Permissions Protection Domains MIDlet suite permissions Signing a MIDlet Suite Managing Keys Creating a New Key Pair Getting Real Keys Creating a new key pair Managing Certificates Importing an Existing Key PairRemoving a Key Pair Importing Certificates Certificate manager Removing Certificates Using the Wireless Messaging API Setting Emulator Phone Numbers Setting WMA preferences Simulating an Unreliable Network Sending Messages With the WMA Console Sending a Text SMS Message Sending a Binary SMS Message Sending a text message Sending Text or Binary CBS Messages Sending a binary message Sending MMS Messages Sending CBS messages Adding recipients for an MMS message Using the Network Monitor with WMA Receiving Messages in the WMA Console 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 Retained Mode Trading Quality for Speed Creating Mobile 3D Graphics Content 70 J2ME Wireless Toolkit User’s Guide October Using the PIM and FileConnection APIs FileConnection API PIM API Managing filesystem roots Using the Bluetooth and Obex APIs Bluetooth Simulation EnvironmentObex Over Infrared Setting Obex and Bluetooth Preferences Obex Preferences Bluetooth Discovery Timeout Bluetooth System PropertiesBluetooth BCC Properties BCC properties 76 J2ME Wireless Toolkit User’s Guide October Using Web Services Web services stub generator 78 J2ME Wireless Toolkit User’s Guide October Application Demonstrations Overview \WTK22\apps\WMADemo\src\example\sms\SMSSend.java Application demonstrations General Instructions KToolbar BluetoothDemo Opening a demonstration application project Running the Bluetooth Demo server Demo3D Life3D PogoRoo Controls for Life3D Retainedmode Bouncing kangaroo JSR172Demo Mmademo Simple Tones Simple Player Player commands PausingAudioTest Video ObexDemo Attributes for mmademoDescriptions of MMAPI-specific MIDlet attributes Waiting for an Obex connection Prompting to accept a connection PDAPDemo Browsing Files Contents of the root1 directory PIM API Choosing a list type To actually save the list item, choose Commit from the menu WMADemo Saving an item 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 Debugging Remove=storagename storagenumber all Toolkit component commands Launching Toolkit GUI ComponentsEmulator Preferences Properties List Monitor Enable memory monitor Using Security Features Changing the Emulator’s Default Protection Domain Signing MIDlet Suites Managing Certificates Using the Stub Generator Options for the wscompile CommandOptions Command Supported Features -f for wscompile Example Locale Setting Internationalization Emulated Locale Character Encodings Font Support in the Default Emulator Java Compiler Encoding Setting 118 J2ME Wireless Toolkit User’s Guide October Index Ktools.properties, 27 ktools.properties ﬁle Index 122 J2ME Wireless Toolkit User’s Guide October