blob: 6d1835743efe19646831b4a7f319ec1abe44b991 [file] [log] [blame]
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference id="u_device-manager_android" xml:lang="en-us">
<title>Device Management view</title>
<shortdesc>Lists available devices (both physical and virtual) and allows you to install applications to them.</shortdesc>
<p>The Device Management view displays any connected Android devices and any available Android Virtual Devices
(AVDs), identified by name and categorized by type. For each device, the Devices column also includes the AVD
name and operating system version (for running emulated devices) or device ID and operating system version (for
real devices). The Status column indicates whether the device is online (an AVD that is online is one that is
running) or offline. If an AVD shows "no user data", that AVD has no associated user data: either it has never
been run, or it has been reset since it was last run.</p>
<p>Right-click a device to display a menu that varies depend upon the type of device you have selected. When a
physical device is selected you can open an ADB shell window or install an application to the device. When an
AVD is selected you can also start, stop, or reset the virtual device, and you can open an Android console
<stentry><image href="../images/tml-new-instance.png"/></stentry>
<stentry>Creates a new device. Use this to create new AVD instances.</stentry>
<stentry><image href="../images/refresh-device-list-button_android.png"/></stentry>
<stentry>Refreshes the list of devices and their status indications.</stentry>
<stentry><image href="../images/menu-button.png"/></stentry>
<stentry>Displays a menu that allows you to create a new device.</stentry>
<p>The context-sensitive menu that appears when you right-click a device has some or all of the following commands
(depending upon whether the device is real or emulated).</p>
<stentry><image href="../images/dev-mgr_new-icon.png"/></stentry>
<stentry>Creates a new AVD.</stentry>
<stentry><image href="../images/loc_editor-remove-line-button.png"/></stentry>
<stentry>Deletes an existing AVD.</stentry>
<stentry>Opens a dialog from which you can view and edit some of the device's properties.</stentry>
<stentry><uicontrol>ADB Shell</uicontrol></stentry>
<stentry><image href="../images/dev-mgr_adb-shell-icon.png"/></stentry>
<stentry>Opens a new ADB (Android Debug Bridge) shell console from which you can issue adb commands. These
commands allow you to manage the state of connected Android devices and AVDs. See the Android SDK
documentation at <xref href=""
scope="external" format="html"></xref> for
information on the commands you can issue.</stentry>
<stentry><image href="../images/dev-mgr_console-icon.png"/></stentry>
<stentry>Opens a new Emulator Console connected to the selected emulator instance. You can use the Emulator
Console to simulate hardware events, simulate telephony events, and control various aspects of the emulated
device. For more information see the Android SDK documentation for the Emulator Console at <xref
href="" scope="external"
<stentry><uicontrol>Install app</uicontrol></stentry>
<stentry><image href="../images/dev-mgr_install-app-icon.png"/></stentry>
<stentry>Prompts you for an application package, and then installs the package to the selected device. Note
that the target device must be running. Also note that you can install apps simply by dragging and dropping
one or more APKs onto a running AVD or connected handset listed in the Device Management view.</stentry>
<stentry><uicontrol>Uninstall app</uicontrol></stentry>
<stentry><image href="../images/dev-mgr_uninstall-app-icon.png"/></stentry>
<stentry>Lists applications that can be uninstalled, and uninstalls those that you have selected.</stentry>
<stentry><uicontrol>Take Screenshot</uicontrol></stentry>
<stentry><image href="../images/dev-mgr_take-screenshot-icon.png"/></stentry>
<stentry>Captures an image of the device's screen. This function works for both real and emulated
<stentry><uicontrol>Test events with Monkey</uicontrol></stentry>
<stentry><image href="../images/dev-mgr_monkey-test-icon.png"/></stentry>
<stentry>Creates a launch configuration for the Android UI/Application Exerciser Monkey, which tests your apps
by sending pseudo-random events to them.</stentry>
<stentry><image href="../images/dev-mgr_language-icon.png"/></stentry>
<stentry>Changes the locale of the selected emulator instance. The emulator must be running. This feature is
particularly useful when testing localized versions of your applications. Note that it lets you change the
emulated device's locale to any language/country combination, whether or not the device has the specified
locale installed. If the locale is not installed the device defaults to English, but within your application
your localized strings.xml file is used.</stentry>
<stentry><image href="../images/dev-mgr_reset-icon.png"/></stentry>
<stentry>Deletes all of the selected emulator's data. This has the same effect as deleting and recreating the
<stentry><image href="../images/dev-mgr_stop-icon.png"/></stentry>
<stentry>Stops the selected emulator instance.</stentry>
<stentry><image href="../images/dev-mgr_repair-icon.png"/></stentry>
<stentry>Tries to repair a corrupt AVD (depending upon the problem) so that it can once again be
<stentry><image href="../images/dev-mgr_start-icon.png"/></stentry>
<stentry>Starts the selected emulator instance.</stentry>
<stentry><uicontrol>Analyze Memory with MAT</uicontrol></stentry>
<stentry><image href="../images/dev-mgr_mat-analyze-icon.png"/></stentry>
<stentry>Generates an HPROF file and then runs the Memory Analyzer (MAT). MAT analyzes the Java heap and can
be extremely helpful when trying to track down memory leaks. It is also a valuable tool when trying to
reduce your app's memory consumption.</stentry>
<p>The toolbar icons across the top of the Device Management view correspond to many of the above commands. These
icons are enabled and disabled as appropriate for the selected devices. Note that they enable you to issue
commands to more than one device at a time. For instance, you can start multiple AVDs by selecting them and
clicking <image href="../images/start-avd-button.png"/>.</p>