blob: b945d3a5bdbd7b59741bea0dc755e2f8625e56ad [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-monkey-main">
<title>Run Configurations (Monkey) dialog</title>
<shortdesc>A "Test events with Monkey" run configuration brings together all of the information needed to execute the
UI/Application Exerciser Monkey against a specific set of executables on a specific device instance, making it
simple to repeatedly test those executables on that device instance.</shortdesc>
<p>You can create different <term>run configurations</term> in order to test Android applications on real or
emulated devices. A run configuration encapsulates all of the information relating to a single test scenario
into a single entity. It identifies not only the specific packages to be exercised, but the device on which the
test is to be run. By creating multiple run configurations, you can quickly and easily switch between them to
try out different test scenarios.</p>
<p>The Run Configurations dialog appears when you right-click a running emulator or connected device in the Device
Management view and select <uicontrol>Test events with Monkey</uicontrol>.</p>
<p>The Run Configurations dialog is organized into two tabs: <uicontrol>Main</uicontrol> is where you specify the
device on which to run, the packages to be exercised, and the number of events to generate and send. <uicontrol
>Options</uicontrol> allows you to fine-tune the events that are sent.</p>
<title>Main tab</title>
<stentry>Specifies the running emulator or connected device on which the test is to take place.</stentry>
<stentry>Package list</stentry>
<stentry>Lists the packages to which events can be sent. Select those packages that should receive the events
generated by the UI/Application Exerciser Monkey. You can select one or several packages; Monkey will limit
its scope only to the selected packages. To select a single package, click it. To select a block of adjacent
packages, click the first and then Shift-click the last. To select several individual packages, click the
first one and then Control-click (Command-click, on Macintosh) the remaining packages.</stentry>
<stentry><uicontrol>Event count</uicontrol></stentry>
<stentry>Specifies the number of events to be generated and sent.</stentry>
<title>Options tab</title>
<p>Contains fields that allow you to further customize the way that that Monkey tests your applications. See the
UI/Application Exerciser Monkey documentation provided with the Android SDK for information on the purpose and
allowable values for each of these fields. Note that you can select <uicontrol>General</uicontrol> and supply
options as command-line parameters, rather than as form values.</p>