UEI Emulator Tool

The UEI emulator tool is used by an integrated IDE to launch an on-device source-level debugging session using KDWP and a Sony Ericsson phone. This tool is implemented according to the UEI specification.

SYNOPSIS

emulator [args] [application]

DESCRIPTION

The emulator command line tool is used to send commands to the Java Virtual Machine inside of a Sony Ericsson mobile device.

ARGUMENTS

General Options

-Xdevice:[device-name]

This option specifies the name of the device for which to run the command.

Commands

-version

Writes version information to standard output.

-help

Writes command help to standard output.

-Xdescriptor:[jad-file]

Installs and runs an application using the specified Java Application Descriptor File. NOTE: The -Xdescriptor command line option is not valid when using the -Xjam command line option.

Options:

-classpath [path]

Specifies the classpath that the emulator uses to locate Java class files and resource files. The application will be removed from the device after it has finished.

-Xdebug

Enables runtime debugging. The application will be removed from the device after it has finished.
-Xrunjdwp and -Xdevice must also be specified.

-Xrunjdwp: transport=dt_socket, address=[host:port], server=y/n

Start a JDWP debug session using sockets as the transport mechanism. Currently, the dt_socket mechanism is the only supported mechanism. Specify the transport address for the debugger connection that is used when starting a JDWP debug session. The server property is optional. When server=y the debug agent is started as a server. The dubugger must connect to the port specified. Default is server=y. -Xdebug and -Xdevice must also be specified.

-Xquery

Returns information about the emulator and supported devices. This information is written to standard output.

-Xjam:install=[jad|jar]

Installs the specified JAD or JAR file. -Xjam:force must accompany -Xjam:install.

Mandatory option:

-Xjam:force

When set to true, if an existing MIDlet has the same storage name as the MIDlet to be installed, the existing MIDlet is forcefully removed from the device prior to installing the new MIDlet. -Xjam:force and -Xjam:force=true both means that force is set.

-Xjam:run=[application]

Runs the midlet passed as the application argument. The [application] argument shall be in the format midlet_id-entry_point, e.g. -Xjam:run=2-65537.

-Xjam:remove=[application]

Removes the midlet passed as the application argument. The [application] argument shall specify the midlet_id, e.g. -Xjam:remove=2.

-Xjam:transient=[jad|jar]

Installs, runs and removes the specified JAD or JAR file.

-Xjam:list

Lists all installed midlets in human readable form.

-Xjam:storageNames

Lists all installed midlets, one per line.