Install, Emulator AMS welcome screen | Sun Microsystems J2ME

2.3.2Install

To properly test a MIDlet suite, you should install it into the toolkit’s emulator or a real device. When you press the Run button in KToolbar, the MIDlet suite is not installed into the emulator. Instead, the emulator runs the MIDlet classes directly.

The emulator also has the capability of installing applications into its memory in a process that resembles how applications are transmitted and installed on real devices. To install applications in the J2ME Wireless Toolkit emulator, choose Project > Run via OTA.

The emulator window pops open, but instead of running your MIDlet classes directly, this time the emulator shows the welcome screen of its Application Management Software (AMS). The emulator’s AMS is an example of the type of software that real devices must have to manage MIDlet suites.

FIGURE 8 Emulator AMS welcome screen

Choose Apps to go to the main list of installed applications. Select Install Application and press the select button on the emulator. The emulator prompts you for the URL location of the application you want to install. The URL is already filled in for you.

12 J2ME Wireless Toolkit User’s Guide • October 2004

Image 24

Sun Microsystems J2ME manual Install, Emulator AMS welcome screen

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