blob: a4d837d7c34dfd61d86f398e1e2d6c713520a571 [file] [log] [blame]
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "../dtd/task.dtd">
<task id="t_emulator_external" xml:lang="en-us">
<title>Opening the emulator in an external window</title>
<shortdesc>MOTODEV Studio normally presents emulated devices in the Android Emulator view. If you prefer, though,
emulated devices can be displayed in a window external to MOTODEV Studio.</shortdesc>
<p>By default, MOTODEV Studio for Android opens the device emulator in an Eclipse view. Except on Mac OS X, to
work with the emulator in a separate window simply close the Android Emulator view and click <uicontrol
>No</uicontrol> when you are asked if running emulator instances should be stopped. The reverse works as you
might expect: while the emulator is running externally if you open the Android Emulator view the emulator will
be shown in that view (rather than externally).</p>
<p>On Mac OS X, things work a bit differently. Here, each AVD has an associated property that controls whether or
not the emulator is shown externally. In addition, if the Android Emulator view is open, the emulator is shown
there. This means that you can show the emulator in a view, or externally, or in both places at once, or in
neither place. </p>
<p><b>The remainder of this document assumes that you are running Mac OS X.</b>
<p>AVDs are presented within the Android Emulator view by default. To specify that an AVD be opened externally at
the time you create it: click <uicontrol>Next</uicontrol> after filling out the dialog asking for the AVD target
and skin. In the dialog that follows (the one in which you set startup options for the AVD), on the <uicontrol
>Others</uicontrol> tab, remove the <uicontrol>-no-window</uicontrol> option.</p>
<p>To alter an existing AVD so that it opens externally:</p>
<cmd>Right-click the AVD and select <uicontrol>Properties</uicontrol>.</cmd>
<stepresult>The Properties dialog appears.</stepresult>
<cmd>In the Properties dialog, select <menucascade><uicontrol>Android Virtual Device</uicontrol><uicontrol
>Startup Options</uicontrol></menucascade>.</cmd>
<cmd>In the Startup Options dialog, on the <uicontrol>Others</uicontrol> tab, clear the <uicontrol
>-no-window</uicontrol> option.</cmd>
<cmd>Click <uicontrol>OK</uicontrol> to save your changes and close the dialog</cmd>
<note type="important">If the AVD is running at the time you make this change, you will need to stop and
restart the AVD.</note>
<cmd>If you do not wish to also see the emulator presented in the Android Emulator view, close that view. </cmd>
<postreq>Note that if the AVD has the <uicontrol>-no-window</uicontrol> option set and you elect not to have the
emulator presented within an Eclipse view, the AVD will not be displayed. Conversely, if you leave the <uicontrol
>-no-window</uicontrol> option set and you also specify that the emulator is to be displayed within an Eclipse
view, it will appear both within Eclipse and in a separate window. </postreq>