Launch Configuration Settings

This dialog provides details on the individual settings on a Wireless Toolkit Emulator Launch Configuration.

  1. MIDlet tab
  2. Emulation tab
  3. Source tab
  4. Common tab

Midlet tab

The MIDlet tab controls the method via which Eclipse launches the debug session. You have two choices: Midlet launching and Over The Air.

screenshot

Tab items:

ItemContents

Midlet Launching

When Midlet launching is specified, the emulator is instructed to execute the midlet from the local file system. Using this method of launching, it is not necessary to package the MIDlet prior to debugging.

When you select this option, you must provide the name of your MIDlet class.

Over The Air

When Over the Air is specified, the Eclipse emulator's Java Application Manager (JAM) will be instructed to contact EclipseME's built in HTTP server to download the suite. Starting with version 0.5.5, the Over the Air Preferences default to automatically deploying the project prior to launch. If you have disabled this feature, you will need to manually deploy the project prior to using this mode.

Emulation tab

The Emulation tab controls the particular emulated device in which the MIDlet will be launched. The settings available depend on the particular wireless toolkit that the project is set to use.

screenshot

Tab items:

ItemContents

Platform Definition

The Platform Definition settings allow you to choose the platform under which your MIDlet will be emulated. This is useful, for example, if you have written the MIDlet using one platform definition, and then want to test it for compatibility under another.

By default, the MIDlet will be run under the platform defined in the project properties. To change to a different platform, select the second radio button and choose the platform from the pull-down list.

Device

This setting allows you to choose the specific device within the platform under which your MIDlet will be emulated.

Security Domain

This pull-down list allows you to launch the emulator with a particular security domain selected. This can be useful to debug a signed MIDlet. For more information, see About MIDlet Suite Signing.

Extra Emulation Parameters

You have the option of adding extra parameters that will be passed directly to the emulator. This is useful if, for example, you want to enable tracing in the target JVM/KVM.

Source tab

The Source tab is a standard Eclipse option that allows you to control where Eclipse will look for your source files.

screenshot

Common tab

The Comon tab is a standard Eclipse option that allows you to choose whether your Launch Configuration is Local or Shared, and whether it will appear in the Run or Debug menus.

screenshot