Several Android and iOS devices can be connected to the same computer simultaneously. Tests created for Android devices cannot be executed on iOS devices and vice versa. Attempts to run a test on an inappropriate platform will most likely cause errors. To avoid such situations, you can check the type of the mobile operating system before performing any test actions.
Besides, some objects or members may have similar functionality, but their names may be different on different platforms. To address the appropriate object or member, you need to know which operating system is running on the current device as well.
To determine the type of the mobile operating system, read the OSType property of the object that corresponds to the desired mobile device. This property returns the type of the operating system installed on the device: Android or iOS.
Verifying the Mobile Platform in Keyword TestsVerifying the Mobile Platform in Keyword Tests
In keyword tests, use the If...Then operation to verify the type of the mobile OS. To configure this operation:
-
Add the If... Then operation to your keyword test. TestComplete will display the Operation Parameters wizard.
-
In the Value 1 column, enter one of the following:
-
Aliases.Device.OSType- if you use Name Mapping, -
Mobile.Device.OSType- if you do not use Name Mapping, -
Mobile.Device("DeviceName").OSType- if you do not use Name Mapping and the device is not the current one.
-
-
In the Condition column, select the desired condition: either Equals or Not equals.
-
In the Value 2 column, enter the name of the operating system to be checked: Android or iOS.
-
Click Finish.
-
Add the operations to be performed after the verification is complete as child operations of the If...Then operation.
The following keyword test verifies the mobile platform and proceeds to test actions only if the device runs Android.
Verifying the Mobile Platform in Scripts
To verify the mobile platform in scripts, you can compare the value of the OSType property within the if...then statements.
The following script verifies the mobile platform and proceeds to test actions only if the device runs Android.
JavaScript, JScript
function TestWithOSTypeVerification()
{
...
// Verify the mobile OS type
if (Mobile.Device().OSType!="Android")
{
Log.Warning("This test is for Android devices only.")
// Exit the test for the current device
return;
}
// Perform a mobile test for Android devices
...
}
Python
def TestWithOSTypeVerification():
# ...
# Verify the mobile OS type
if (Mobile.Device().OSType != "Android"):
Log.Warning("This test is for Android devices only.")
# Exit the test for the current device
return;
# Perform a mobile test for Android devices
# ...VBScript
Sub TestWithOSTypeVerification
...
' Verify the mobile OS type
If (Mobile.Device.OSType<>"Android")Then
Log.Warning("This test is for Android devices only.")
' Exit the test for the current device
Exit Sub
End If
' Perform a mobile test for Android devices
...
End Sub
DelphiScript
procedure TestWithOSTypeVerification;
begin
...
// Verify the mobile OS type
if (Mobile.Device.OSType<>'Android') then
begin
Log.Warning('This test is for Android devices only.');
// Exit the test for the current device
exit;
end;
// Perform a mobile test for Android devices
...
end;
C++Script, C#Script
function TestWithOSTypeVerification()
{
...
// Verify the mobile OS type
if (Mobile["Device"]["OSType"] != "Android")
{
Log["Warning"]("This test is for Android devices only.")
// Exit the test for the current device
return;
}
// Perform a mobile test for Android devices
...
}
Implicit Verification Through Name Mapping
If you address a mobile device using its mapped name or alias (NameMapping.Mobile.Device or Aliases.Device) and the mapped name was created automatically, then the verification of the mobile OS type is performed implicitly. This is because the value of the OSType property is used as the default mapping criterion for the objects that represent the mobile device. This helps TestComplete choose the appropriate mobile device for the test automatically (a script or in a keyword test).
Suppose, an Android device and an iOS device are connected to your computer and you have a keyword test that works with an Android application. When you start this test, TestComplete will automatically select the Android device, since the iOS device will not match the mapping criterion.