io.appium.java_client.android

Class AndroidMobileCommandHelper

java.lang.Object

io.appium.java_client.MobileCommand

io.appium.java_client.android.AndroidMobileCommandHelper

public class AndroidMobileCommandHelper
extends MobileCommand

This util class helps to prepare parameters of Android-specific JSONWP commands.

Field Summary

Fields inherited from class io.appium.java_client.MobileCommand

CLOSE_APP, commandRepository, CURRENT_ACTIVITY, END_TEST_COVERAGE, FINGER_PRINT, GET_CURRENT_PACKAGE, GET_DEVICE_TIME, GET_DISPLAY_DENSITY, GET_NETWORK_CONNECTION, GET_PERFORMANCE_DATA, GET_SESSION, GET_SETTINGS, GET_STRINGS, GET_SUPPORTED_PERFORMANCE_DATA_TYPES, GET_SYSTEM_BARS, HIDE_KEYBOARD, INSTALL_APP, IS_APP_INSTALLED, IS_KEYBOARD_SHOWN, IS_LOCKED, LAUNCH_APP, LOCK, LONG_PRESS_KEY_CODE, OPEN_NOTIFICATIONS, PERFORM_MULTI_TOUCH, PERFORM_TOUCH_ACTION, PRESS_KEY_CODE, PULL_FILE, PULL_FOLDER, PUSH_FILE, REMOVE_APP, REPLACE_VALUE, RESET, RUN_APP_IN_BACKGROUND, SET_NETWORK_CONNECTION, SET_SETTINGS, SET_VALUE, SHAKE, START_ACTIVITY, TOGGLE_LOCATION_SERVICES, TOUCH_ID, TOUCH_ID_ENROLLMENT, UNLOCK

Constructor Summary

Constructors

Constructor and Description
AndroidMobileCommandHelper()

Method Summary

Modifier and Type	Method and Description
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	currentActivityCommand() This method forms a Map of parameters for the getting of the current activity.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	currentPackageCommand() This method forms a Map of parameters for the getting of the current package.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	endTestCoverageCommand(java.lang.String intent, java.lang.String path) This method forms a Map of parameters for the ending of the test coverage.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	fingerPrintCommand(int fingerPrintId) This method forms a Map of parameters for the finger print authentication invocation.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	getDisplayDensityCommand() This method forms a Map of parameters to Retrieve the display density of the Android device.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	getNetworkConnectionCommand() This method forms a Map of parameters for the getting of a network connection value.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	getPerformanceDataCommand(java.lang.String packageName, java.lang.String dataType, int dataReadTimeout) returns the resource usage information of the application. the resource is one of the system state which means cpu, memory, network traffic, and battery.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	getSupportedPerformanceDataTypesCommand() returns the information type of the system state which is supported to read as like cpu, memory, network traffic, and battery.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	getSystemBarsCommand() This method forms a Map of parameters to Retrieve visibility and bounds information of the status and navigation bars.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	isKeyboardShownCommand() This method forms a Map of parameters for the checking of the keyboard state (is it shown or not).
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	isLockedCommand() This method forms a Map of parameters for the checking of the device state (is it locked or not).
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	openNotificationsCommand() This method forms a Map of parameters for the notification opening.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	replaceElementValueCommand(org.openqa.selenium.internal.HasIdentity hasIdentityObject, java.lang.String value) This method forms a Map of parameters for the element value replacement.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	setConnectionCommand(Connection connection) This method forms a Map of parameters for the setting of device network connection.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	startActivityCommand(java.lang.String appPackage, java.lang.String appActivity, java.lang.String appWaitPackage, java.lang.String appWaitActivity, java.lang.String intentAction, java.lang.String intentCategory, java.lang.String intentFlags, java.lang.String optionalIntentArguments, boolean stopApp) This method forms a Map of parameters for the activity starting.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	toggleLocationServicesCommand() This method forms a Map of parameters for the toggling of location services.
static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>>	unlockCommand() This method forms a Map of parameters for the device unlocking.

Methods inherited from class io.appium.java_client.MobileCommand

deleteC, getC, getSettingsCommand, hideKeyboardCommand, hideKeyboardCommand, lockDeviceCommand, longPressKeyCodeCommand, longPressKeyCodeCommand, postC, prepareArguments, prepareArguments, pressKeyCodeCommand, pressKeyCodeCommand, pushFileCommand, setSettingsCommand

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AndroidMobileCommandHelper

public AndroidMobileCommandHelper()

Method Detail

currentActivityCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> currentActivityCommand()

This method forms a Map of parameters for the getting of the current activity.

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

currentPackageCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> currentPackageCommand()

This method forms a Map of parameters for the getting of the current package.

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

endTestCoverageCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> endTestCoverageCommand(java.lang.String intent,
                                                                                                             java.lang.String path)

This method forms a Map of parameters for the ending of the test coverage.

Parameters:

intent - intent to broadcast.

path - path to .ec file.

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

getSupportedPerformanceDataTypesCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> getSupportedPerformanceDataTypesCommand()

returns the information type of the system state which is supported to read as like cpu, memory, network traffic, and battery.

Returns:

output - array like below [cpuinfo, batteryinfo, networkinfo, memoryinfo]

getPerformanceDataCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> getPerformanceDataCommand(java.lang.String packageName,
                                                                                                                java.lang.String dataType,
                                                                                                                int dataReadTimeout)
                                                                                                         throws java.lang.Exception

returns the resource usage information of the application. the resource is one of the system state which means cpu, memory, network traffic, and battery.

Parameters:

packageName - the package name of the application

dataType - the type of system state which wants to read. It should be one of the supported performance data types, the return value of the function "getSupportedPerformanceDataTypes"

dataReadTimeout - the number of attempts to read

Returns:

table of the performance data, The first line of the table represents the type of data. The remaining lines represent the values of the data. in case of battery info : [[power], [23]] in case of memory info : [[totalPrivateDirty, nativePrivateDirty, dalvikPrivateDirty, eglPrivateDirty, glPrivateDirty, totalPss, nativePss, dalvikPss, eglPss, glPss, nativeHeapAllocatedSize, nativeHeapSize], [18360, 8296, 6132, null, null, 42588, 8406, 7024, null, null, 26519, 10344]] in case of network info : [[bucketStart, activeTime, rxBytes, rxPackets, txBytes, txPackets, operations, bucketDuration,], [1478091600000, null, 1099075, 610947, 928, 114362, 769, 0, 3600000], [1478095200000, null, 1306300, 405997, 509, 46359, 370, 0, 3600000]] in case of network info : [[st, activeTime, rb, rp, tb, tp, op, bucketDuration], [1478088000, null, null, 32115296, 34291, 2956805, 25705, 0, 3600], [1478091600, null, null, 2714683, 11821, 1420564, 12650, 0, 3600], [1478095200, null, null, 10079213, 19962, 2487705, 20015, 0, 3600], [1478098800, null, null, 4444433, 10227, 1430356, 10493, 0, 3600]] in case of cpu info : [[user, kernel], [0.9, 1.3]]

Throws:

java.lang.Exception - if the performance data type is not supported, thows Error

getDisplayDensityCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> getDisplayDensityCommand()

This method forms a Map of parameters to Retrieve the display density of the Android device.

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

getNetworkConnectionCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> getNetworkConnectionCommand()

This method forms a Map of parameters for the getting of a network connection value.

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

getSystemBarsCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> getSystemBarsCommand()

This method forms a Map of parameters to Retrieve visibility and bounds information of the status and navigation bars.

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

isKeyboardShownCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> isKeyboardShownCommand()

This method forms a Map of parameters for the checking of the keyboard state (is it shown or not).

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

isLockedCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> isLockedCommand()

This method forms a Map of parameters for the checking of the device state (is it locked or not).

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

fingerPrintCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> fingerPrintCommand(int fingerPrintId)

This method forms a Map of parameters for the finger print authentication invocation.

Parameters:

fingerPrintId - finger prints stored in Android Keystore system (from 1 to 10)

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

openNotificationsCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> openNotificationsCommand()

This method forms a Map of parameters for the notification opening.

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

setConnectionCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> setConnectionCommand(Connection connection)

This method forms a Map of parameters for the setting of device network connection.

Parameters:

connection - The bitmask of the desired connection

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

startActivityCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> startActivityCommand(java.lang.String appPackage,
                                                                                                           java.lang.String appActivity,
                                                                                                           java.lang.String appWaitPackage,
                                                                                                           java.lang.String appWaitActivity,
                                                                                                           java.lang.String intentAction,
                                                                                                           java.lang.String intentCategory,
                                                                                                           java.lang.String intentFlags,
                                                                                                           java.lang.String optionalIntentArguments,
                                                                                                           boolean stopApp)
                                                                                                    throws java.lang.IllegalArgumentException

This method forms a Map of parameters for the activity starting.

Parameters:

appPackage - The package containing the activity. [Required]

appActivity - The activity to start. [Required]

appWaitPackage - Automation will begin after this package starts. [Optional]

appWaitActivity - Automation will begin after this activity starts. [Optional]

intentAction - Intent action which will be used to start activity [Optional]

intentCategory - Intent category which will be used to start activity [Optional]

intentFlags - Flags that will be used to start activity [Optional]

optionalIntentArguments - Additional intent arguments that will be used to start activity [Optional]

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

Throws:

java.lang.IllegalArgumentException - when any required argument is empty

toggleLocationServicesCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> toggleLocationServicesCommand()

This method forms a Map of parameters for the toggling of location services.

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

unlockCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> unlockCommand()

This method forms a Map of parameters for the device unlocking.

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.

replaceElementValueCommand

public static java.util.Map.Entry<java.lang.String,java.util.Map<java.lang.String,?>> replaceElementValueCommand(org.openqa.selenium.internal.HasIdentity hasIdentityObject,
                                                                                                                 java.lang.String value)

This method forms a Map of parameters for the element value replacement. It is used against input elements

Parameters:

hasIdentityObject - an instance which contains an element ID

value - a new value

Returns:

a key-value pair. The key is the command name. The value is a Map command arguments.