Start activity (FR)

Perfecto Command

mobile:activity:open

Purpose

Starts an Android activity on the device. Android applications are composed of a series of "Activity" units. Each Activity presents a UI screen that allows users to perform some part of the application, such as call a number, take a photo, send an email, or view a map. When testing the application, it may be desirable to start the application execution from a specific Activity, rather than the initial Activity (usually referred to as the .Main).

Applications can be large and complex, written by many development teams. The start activity and sync activity commands enable a tester to start and sync a specific activity on the device and decreases the time it takes to write a test, allowing more coverage in a dynamic environment where time to develop tests is short.

Parameters

Name	Type	Description
package (Mandatory)	String	The Android application identifier. Example: `com.sec.android.app.camera`
activity (Mandatory)	String	The activity name. Example: `.Camera`
action	String	The `intent` action name.
category	String	The `intent` category name.
flags	String	The `intent` flags name.
arguments	String	The `intent` arguments name.

To retrieve the currentActivity and currentPackage values to use with this function, use the mobile:device:info function while running the activity.

The intent is the normal Android mechanism to pass information between application activities.

Return Value

String: OK | Failed

Exceptions

None

Examples

Copy

Java sample

Map<String, Object> params = new HashMap<>();
params.put("package", "com.google.android.keep");
params.put("activity", ".BrowseActivity");
String result = (String) driver.executeScript("mobile:activity:open", params);

Copy

C# sample

Dictionary<String, Object> pars = new Dictionary<String, Object>();
pars.Add("package", "com.google.android.keep");
pars.Add("activity", ".BrowseActivity");
String result = (String) driver.ExecuteScript("mobile:activity:open", pars);