Share via


Context.StartInstrumentation(ComponentName, String, Bundle) Method

Definition

Start executing an android.app.Instrumentation class.

[Android.Runtime.Register("startInstrumentation", "(Landroid/content/ComponentName;Ljava/lang/String;Landroid/os/Bundle;)Z", "GetStartInstrumentation_Landroid_content_ComponentName_Ljava_lang_String_Landroid_os_Bundle_Handler")]
public abstract bool StartInstrumentation (Android.Content.ComponentName className, string? profileFile, Android.OS.Bundle? arguments);
[<Android.Runtime.Register("startInstrumentation", "(Landroid/content/ComponentName;Ljava/lang/String;Landroid/os/Bundle;)Z", "GetStartInstrumentation_Landroid_content_ComponentName_Ljava_lang_String_Landroid_os_Bundle_Handler")>]
abstract member StartInstrumentation : Android.Content.ComponentName * string * Android.OS.Bundle -> bool

Parameters

className
ComponentName

Name of the Instrumentation component to be run.

profileFile
String

Optional path to write profiling data as the instrumentation runs, or null for no profiling.

arguments
Bundle

Additional optional arguments to pass to the instrumentation, or null.

Returns

true if the instrumentation was successfully started, else false if it could not be found.

Attributes

Remarks

Start executing an android.app.Instrumentation class. The given Instrumentation component will be run by killing its target application (if currently running), starting the target process, instantiating the instrumentation component, and then letting it drive the application.

This function is not synchronous -- it returns as soon as the instrumentation has started and while it is running.

Instrumentation is normally only allowed to run against a package that is either unsigned or signed with a signature that the the instrumentation package is also signed with (ensuring the target trusts the instrumentation).

Java documentation for android.content.Context.startInstrumentation(android.content.ComponentName, java.lang.String, android.os.Bundle).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to