Context.StartInstrumentation(ComponentName, String, Bundle) Method

Reference

Definition

Namespace:: Android.Content

Assembly:: Mono.Android.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Boolean

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

Attributes: RegisterAttribute

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