This document describes the management of device definitions in EclipseME.
Device Management Preferences
In order to use EclipseME, you must configure at least one Device Definition. Device management in EclipseME allows significant control over the device definitions available to MIDlet Suites and emulator launching. Devices are managed from within the Preferences dialog of Eclipse. To reach the device management functionality:
The Device Management page displays the devices that are currently known to EclipseME. From this page, it is possible to import new devices, redefine current devices and remove definitions.
The Default column allows a single device to be chosen as the default. The default device will be initially selected when creating new MIDlet suites and emulator launch configurations.
EclipseME is aware by default of a number of different types of wireless toolkits and their associated structure. These devices can be imported into EclipseME automatically for use by project definitions and emulator launching.
Duplicate a Device Definition
In certains cases, you may find that an imported device definition is close to what you would like but could use a few small changes. In a case like this, you may use the Duplicate button to create an exact copy of the selected device definition. The duplicated device definition can then be altered as necessary without changing the original.
NOTE: It is not a requirement that you duplicate a device prior to altering it. If you make changes to an imported device and you would like to get back to the original, simply remove the device definition and re-import it.
Edit a Device Definition
EclipseME attempts to understand many of the wireless toolkits that are available to developers. Unfortunately, keeping up with the different vendors and the various ways that toolkits are structured is very difficult. Even in cases that EclipseME is able to identify and import a device definition, it is possible that it might be incorrect or not quite what you were looking for. Select the Edit... button to launch the edit dialog.
The tabbed dialog provides control over the definition of a device, including the emulator executable, launch command and libraries that define that device. When the edit dialog is opened, the contents will be filled to match the selected device definition. When all changes have been completed, select the OK button on the dialog and OK on the device management preferences.
The first tab of the edit dialog presents many of the properties that make up the definition of the device. Each of these properties works together to provide the environment necessary for EclipseME and care must be taken when making changes. For more information on configuring the properties available on this page, see Editing Basic Device Properties.
The Libraries tab of the edit dialog allows the selection and configuration of the libraries that make up the device definition. Using the controls on this page, it is possible to add and remove functionality from a device definition. This is useful in restricting available API's to create a more generic project. See Editing Device Libraries for more details.
The Properties tab of the edit dialog displays the properties defined by the selected device. Properties may not be altered at this time.
Example: Creating a MIDP 1.0 Device
In many cases, importing devices will result in a device with greater functionality than might be required for testing. It is possible to create a device definition using device management. For example, using the standard wireless toolkit, creation of a MIDP 1.0 device can be done with the following steps.
Copyright © 2005, http://www.eclipseme.org. All rights reserved.