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"><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>" /></pre></dd> 14 15<dt>contained in:</dt> 16<dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code></dd> 17 18<dt>description:</dt> 19<dd>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— "{@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 — "{@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"><manifest></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"><manifest></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