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