1 page.title=<instrumentation> 2 parent.title=The AndroidManifest.xml File 3 parent.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 itemprop="description">Declares an {@link android.app.Instrumentation} class that enables you 20 to monitor an application's interaction with the system. The Instrumentation 21 object 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 28 default 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 32 off — "{@code true}" if it determines when profiling starts and 33 stops, and "{@code false}" if profiling continues the entire time it is 34 running. A value of "{@code true}" enables the object to target profiling 35 at 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 39 be 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 43 be 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. 47 This should be a fully qualified class name (such as, 48 "{@code com.example.project.StringInstrumentation}"). However, as a shorthand, 49 if the first character of the name is a period, it is appended to the package 50 name specified in the <code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code> element. 51 52 <p> 53 There 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. 58 An application is identified by the package name assigned in its manifest 59 file 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
