|
|
|
|
org.eclipse.mtj.core.sdk.device
Interface IDevice
-
All Superinterfaces:
-
IPersistable
-
All Known Subinterfaces:
-
IMIDPDevice
-
public interface IDevice
- extends
IPersistable
The device interface specifies the representation of an emulated device. Each
instance of a SDK must provide a list of emulated devices that implement this
interface.
-
Since:
- 1.0
getClasspath
IDeviceClasspath getClasspath()
- Return the deviceClasspath provided by the device.
This deviceClasspath includes all libraries for the device including
configuration and profile libraries.
-
-
-
Returns:
- the IDeviceClasspath instance that represents the classpath
provided by the device.
getDescription
String getDescription()
- Return the displayable description of this device.
This description will be displayed within the user interface. If this
method returns a null value, the device's name will be used
as the description instead.
-
-
-
Returns:
- the string containing the description of this device or
null if the device's name should be used instead.
getIdentifier
String getIdentifier()
- Return the unique identifier for this device definition. This identifier
will be used internally to manage the device, but will not be displayed
to the user.
-
-
-
Returns:
- the string that represents the unique identifier of this device.
getSymbolSet
ISymbolSet getSymbolSet()
- Return the SymbolSet associated with this device. The SymbolSet should be
based in the devices properties.
Clients may use
MTJCore.getSymbolSetFactory() to get a
ISymbolSetFactory instance which provides a mechanism to create
symbols sets.
-
-
-
Returns:
- the SymbolSet associated with this device.
getSDK
ISDK getSDK()
- Return the SDK that defines this device.
-
-
-
Returns:
-
getSDKName
String getSDKName()
- Return the name of the SDK that contains this device. This method
must never return a
null value as the SDK name.
This value will be used to group devices belong to the same SDK.
-
-
-
Returns:
- the non-
null SDK name associated to this device.
getLaunchCommand
String getLaunchCommand(
LaunchEnvironment launchEnvironment,
IProgressMonitor monitor)
throws CoreException
- Return the command-line arguments for launching this device given the
specified launch environment.
-
-
-
Parameters:
-
launchEnvironment - the launch environment instance that provides
the necessary information to a IDevice implementation for
determining the correct command-line for execution of an
emulator. -
monitor - a progress monitor, or null if progress
reporting is not desired.
-
Returns:
- a String containing the command-line arguments for launching the
IDevice implementation.
-
Throws:
-
CoreException - If fails to determine the launch command line for
the
IDevice implementation.
getName
String getName()
- Return the name of this device. This name will be used when interacting
with the emulator. This name may or may not be displayed within the user
interface, dependent on whether a display name is provided by this
device. This method must never return
null .
-
-
-
Returns:
- the non-null name of this device.
isDebugServer
boolean isDebugServer()
- Return a boolean describing whether this device wants to act as a debug
server rather than attaching to the debugger as a client.
-
-
-
Returns:
- if the device acts as a debug server
setName
void setName(
String name)
- Set the name of this device. This name will be used when interacting with
the emulator. This name may or may not be displayed within the user
interface, dependent on whether a display name is provided by this
device. This method must never return
null .
-
-
-
Parameters:
-
name - the non-null name of this device.
|
|
|