Command Line Reference, Prerequisites | Sun Microsystems J2ME

APPENDIX B

Command Line Reference

This appendix describes how to operate the J2ME Wireless Toolkit from the command line and details the steps required to build and run an application. It also describes the J2ME Wireless Toolkit certificate manager utility, called MEKeyTool, and the MIDlet signing utility, called JAD Tool (Java Application Descriptor Tool).

B.1 Prerequisites

Before building and running an application from the command line, verify that you have a version no earlier than 1.4.2 of the J2SE SDK. Run the jar.exe command (make sure the command is in your PATH) and then run java -versionat the command line to verify that the version of the J2SE SDK that is actually being used is 1.4.2.

For more examples, see the files build.bat and run.bat in the bin directories of the demonstration applications. You can find these files under the {toolkit}\apps\<demo>\bin directory where {toolkit} is the installation directory of the J2ME Wireless Toolkit and <demo> is the name of one of the demo applications.

B.2 The Development Cycle

For a full description of developing MIDP applications, see Chapter 2, “Developing MIDlet Suites.” This section describes how to accomplish each of the steps in the development cycle from the command line.

103

Image 115

Sun Microsystems J2ME manual Command Line Reference, Prerequisites, Development Cycle

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 Who Should Use This Book PrefaceRelated Documentation How This Book Is Organized Preface Typographic Conventions Accessing Documentation OnlineWe Welcome Your Comments Quick Start Introduction KToolbar window Tools in the Toolkit Supported JCP APIs in the J2ME Wireless Toolkit Toolkit FeaturesSupported 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 Project Directory Structure Using Third-Party LibrariesProject directory structure Third-Party Libraries for One Project Configuring KToolbarThird-Party Libraries for All Projects Setting the javac Encoding Property Setting the Application DirectoryWorking with Revision Control Systems 28 J2ME Wireless Toolkit User’s Guide October Emulator Skins Using the EmulatorEmulator skins Using the Emulator DefaultColorPhone emulator skin Network Proxies Setting Emulator PreferencesKeyboard 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 Sorting Messages Network monitor filter settingsSaving 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 Importing an Existing Key Pair Managing CertificatesRemoving 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 Supported Formats and Protocols Using the Mobile Media APISupported Mmapi media formats Media Capture Using MediaControlSkinWell-Behaved MIDlets Working With Mobile 3D Graphics Immediate ModeJSR 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 Bluetooth Simulation Environment Using the Bluetooth and Obex APIsObex Over Infrared Obex Preferences Setting Obex and Bluetooth Preferences BCC properties Bluetooth Discovery TimeoutBluetooth System Properties Bluetooth 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 Attributes for mmademo ObexDemoDescriptions 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 Prerequisites Command Line ReferenceDevelopment Cycle Preverify options files directories Jar cfm MyApp.jar MANIFEST.MF -C classes . -C res Run=storagename storagenumber Remove=storagename storagenumber all Debugging Launching Toolkit GUI Components Toolkit component commandsEmulator Preferences Properties List Monitor Enable memory monitor Changing the Emulator’s Default Protection Domain Using Security Features Signing MIDlet Suites Managing Certificates Options for the wscompile Command Using the Stub GeneratorOptions 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