blob: c6c452d8806468152e00ecde98e13823a9145fbf [file] [log] [blame]
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE reference
PUBLIC "-//OASIS//DTD DITA Reference//EN" "../dtd/reference.dtd">
<reference xml:lang="en-us" id="u_run-config-main">
<title>Run Configurations dialog</title>
<shortdesc>A run configuration brings together all of the information needed to run a specific executable on a
specific device instance, making it simple to repeatedly run that executable on that device instance.</shortdesc>
<prolog>
<metadata>
<keywords>
<!--<indexterm></indexterm>-->
</keywords>
</metadata>
</prolog>
<refbody>
<section>
<p>You can create different <term>run configurations</term> in order to run or debug <ph product="webui"
>WebUI</ph><ph product="android-studio">Android</ph> applications<ph product="webui"> or widgets</ph> on real
or emulated devices. A run configuration encapsulates all of the information relating to a single execution
scenario into a single entity. It identifies not only the specific <ph product="webui">package within a
particular </ph>project to be run, but the device on which it is to be run. By creating multiple run
configurations, you can quickly and easily switch between them to try out different scenarios.</p>
<p>The Run Configurations dialog appears when you select <uicontrol>Run Configurations</uicontrol> from the
<uicontrol>Run</uicontrol> menu and then either create or select an existing <uicontrol>Android Application
using Studio for Android</uicontrol> configuration.</p>
<simpletable>
<strow>
<stentry>
<uicontrol>Project</uicontrol>
</stentry>
<stentry>Specifies the project that contains the application to be run. </stentry>
</strow>
<strow product="webui">
<stentry>
<uicontrol>Package/Descriptor</uicontrol>
</stentry>
<stentry>Specifies the package that corresponds to the application to be run. The package can either be a
<codeph>.descriptor</codeph> or a <codeph>.mpkg</codeph> file. </stentry>
</strow>
<strow>
<stentry>
<uicontrol>Device</uicontrol>
</stentry>
<stentry>Specifies the device instance on which the application should run. This can be either a real or an
emulated device.</stentry>
</strow>
<strow product="webui">
<stentry>
<uicontrol>Signing</uicontrol>
</stentry>
<stentry>Specifies the certificate to be used to sign the application before transferring it to the device. If
the chosen instance is a MOTOMAGX Emulator, this field is disabled; you can only specify a certificate if
the run configuration is for a physical device.</stentry>
</strow>
<strow product="android-studio">
<stentry>
<uicontrol>Activity</uicontrol>
</stentry>
<stentry>Specifies the activity that should be launched, if any. Often you will just want the default activity
to be launched, but you can specify a specific activity by selecting <uicontrol>Launch</uicontrol> and
indicating the activity to be launched. If the project should be installed but not run (as might be in the
case of a widget), select <uicontrol>Do Nothing</uicontrol>.</stentry>
</strow>
</simpletable>
</section>
</refbody>
</reference>