1page.title=<instrumentation>
2parent.title=The AndroidManifest.xml File
3parent.link=manifest-intro.html
4@jd:body
5
6<dl class="xml">
7<dt>syntax:</dt>
8<dd><pre class="stx">&lt;instrumentation android:<a href="#ftest">functionalTest</a>=["true" | "false"]
9                 android:<a href="#hprof">handleProfiling</a>=["true" | "false"]
10                 android:<a href="#icon">icon</a>="<i>drawable resource</i>"
11                 android:<a href="#label">label</a>="<i>string resource</i>"
12                 android:<a href="#nm">name</a>="<i>string</i>"
13                 android:<a href="#trgt">targetPackage</a>="<i>string</i>" /&gt;</pre></dd>
14
15<dt>contained in:</dt>
16<dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html">&lt;manifest&gt;</a></code></dd>
17
18<dt>description:</dt>
19<dd itemprop="description">Declares an {@link android.app.Instrumentation} class that enables you
20to monitor an application's interaction with the system.  The Instrumentation
21object is instantiated before any of the application's components.</dd>
22
23<dt>attributes:</dt>
24<dd><dl class="attr">
25<dt><a name="ftest"></a>{@code android:functionalTest}</dt>
26<dd>Whether or not the Instrumentation class should run as a functional test
27&mdash; "{@code true}" if it should, and "{@code false}" if not.  The
28default value is "{@code false}".</dd>
29
30<dt><a name="hprof"></a>{@code android:handleProfiling}</dt>
31<dd>Whether or not the Instrumentation object will turn profiling on and
32off &mdash; "{@code true}" if it determines when profiling starts and
33stops, and "{@code false}" if profiling continues the entire time it is
34running.  A value of "{@code true}" enables the object to target profiling
35at a specific set of operations.  The default value is "{@code false}".</dd>
36
37<dt><a name="icon"></a>{@code android:icon}</dt>
38<dd>An icon that represents the Instrumentation class.  This attribute must
39be set as a reference to a drawable resource.</dd>
40
41<dt><a name="label"></a>{@code android:label}</dt>
42<dd>A user-readable label for the Instrumentation class.  The label can
43be set as a raw string or a reference to a string resource.</dd>
44
45<dt><a name="nm"></a>{@code android:name}</dt>
46<dd>The name of the {@link android.app.Instrumentation} subclass.
47This should be a fully qualified class name (such as,
48"{@code com.example.project.StringInstrumentation}").  However, as a shorthand,
49if the first character of the name is a period, it is appended to the package
50name specified in the <code><a href="{@docRoot}guide/topics/manifest/manifest-element.html">&lt;manifest&gt;</a></code> element.
51
52<p>
53There is no default.  The name must be specified.
54</p></dd>
55
56<dt><a name="trgt"></a>{@code android:targetPackage}</dt>
57<dd>The application that the Instrumentation object will run against.
58An application is identified by the package name assigned in its manifest
59file by the <code><a href="{@docRoot}guide/topics/manifest/manifest-element.html">&lt;manifest&gt;</a></code> element.</dd>
60
61</dl></dd>
62
63<!-- ##api level indication## -->
64<dt>introduced in:</dt>
65<dd>API Level 1</dd>
66
67</dl>
68