Process Method

Applies to TestComplete 14.50, last modified on April 22, 2021

Description

Returns the AndroidProcess object that corresponds to the package that is currently running on the device.

TestComplete recognizes processes of only those applications that were prepared for testing in a special way. For more information, see Instrumenting Android Applications - Overview.

Declaration

AndroidDeviceObj.Process(ProcessName)

AndroidDeviceObj An expression, variable or parameter that specifies a reference to an AndroidDevice object
ProcessName [in]    Required    String    
Result An AndroidProcess object

Applies To

The method is applied to the following object:

Parameters

The method has the following parameter:

ProcessName

The package name of the Android application, for example, com.example.orders. The process name is case-insensitive.

You can use wildcards (* and ?) to search by a partial name like *.orders.

Result Value

An AndroidProcess object that corresponds to the specified process.

Example

The code below obtains the process by its name:

JavaScript, JScript

function GetProcess()
{
  var proc = Mobile.Device("MyDevice").Process("com.example.orders");
}

Python

def GetProcess():
  proc = Mobile.Device("MyDevice").Process("com.example.orders")

VBScript

Sub GetProcess
  Set proc = Mobile.Device("MyDevice").Process("com.example.orders")
End Sub

DelphiScript

procedure GetProcess();
var proc;
begin
  proc := Mobile.Device('MyDevice').Process('com.example.orders');
end;

C++Script, C#Script

function GetProcess()
{
  var proc = Mobile["Device"]("MyDevice")["Process"]("com.example.orders");
}

See Also

Addressing Objects in Android Open Applications
Testing Android Applications
ProcessName Property
AndroidDevice Object
WaitProcess Method
Process Method (iOS Testing)

Highlight search results