diff options
Diffstat (limited to 'docs/html/guide/topics/manifest/instrumentation-element.jd')
| -rw-r--r-- | docs/html/guide/topics/manifest/instrumentation-element.jd | 61 |
1 files changed, 61 insertions, 0 deletions
diff --git a/docs/html/guide/topics/manifest/instrumentation-element.jd b/docs/html/guide/topics/manifest/instrumentation-element.jd new file mode 100644 index 0000000..fdec949 --- /dev/null +++ b/docs/html/guide/topics/manifest/instrumentation-element.jd @@ -0,0 +1,61 @@ +page.title=<instrumentation> +@jd:body + +<dl class="xml"> +<dt>syntax:</dt> +<dd><pre class="stx"><instrumentation android:<a href="#ftest">functionalTest</a>=["true" | "false"] + android:<a href="#hprof">handleProfiling</a>=["true" | "false"] + android:<a href="#icon">icon</a>="<i>drawable resource</i>" + android:<a href="#label">label</a>="<i>string resource</i>" + android:<a href="#nm">name</a>="<i>string</i>" + android:<a href="#trgt">targetPackage</a>="<i>string</i>" /></pre></dd> + +<dt>contained in:</dt> +<dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code></dd> + +<dt>description:</dt> +<dd>Declares an {@link android.app.Instrumentation} class that enables you +to monitor an application's interaction with the system. The Instrumentation +object is instantiated before any of the application's components.</dd> + +<dt>attributes:</dt> +<dd><dl class="attr"> +<dt><a name="ftest"></a>{@code android:functionalTest}</dt> +<dd>Whether or not the Instrumentation class should run as a functional test +— "{@code true}" if it should, and "{@code false}" if not. The +default value is "{@code false}".</dd> + +<dt><a name="hprof"></a>{@code android:handleProfiling}</dt> +<dd>Whether or not the Instrumentation object will turn profiling on and +off — "{@code true}" if it determines when profiling starts and +stops, and "{@code false}" if profiling continues the entire time it is +running. A value of "{@code true}" enables the object to target profiling +at a specific set of operations. The default value is "{@code false}".</dd> + +<dt><a name="icon"></a>{@code android:icon}</dt> +<dd>An icon that represents the Instrumentation class. This attribute must +be set as a reference to a drawable resource.</dd> + +<dt><a name="label"></a>{@code android:label}</dt> +<dd>A user-readable label for the Instrumentation class. The label can +be set as a raw string or a reference to a string resource.</dd> + +<dt><a name="nm"></a>{@code android:name}</dt> +<dd>The name of the {@link android.app.Instrumentation} subclass. +This should be a fully qualified class name (such as, +"{@code com.example.project.StringInstrumentation}"). However, as a shorthand, +if the first character of the name is a period, it is appended to the package +name specified in the <code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code> element. + +<p> +There is no default. The name must be specified. +</p></dd> + +<dt><a name="trgt"></a>{@code android:targetPackage}</dt> +<dd>The application that the Instrumentation object will run against. +An application is identified by the package name assigned in its manifest +file by the <code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code> element.</dd> + +</dl></dd> + +</dl> |