Home | History | Annotate | Download | only in manifest
      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">&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>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 &mdash; "{@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 &mdash; "{@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">&lt;manifest&gt;</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">&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