Page tree
Skip to end of metadata
Go to start of metadata

Use capabilities to select the device, start applications, control the Perfecto Appium server.

General Settings

CapabilityValueDescription
automationName

Appium (default),
XCUITest,
PerfectoMobile

Which automation engine to use - determines the UIElement Class names identified by the automation engine. See Note below.
Use XCUITest if automating iOS 10 or later native applications, see more details.
Note: use PerfectoMobile for the Perfecto object tree - uses generic UIElement classes.

app The Perfecto repository path to an .ipa or .apk file.
Incompatible with browserName.
browserNameChrome
Safari
MobileOS
MobileDefault
PerfectoMobile
Name of mobile web browser to automate.
Note: For application testing use an empty string.
autoLaunchtrue (default)
false
Whether to have Appium install and launch the app automatically.
udid Unique device identifier of the connected physical device
orientationLANDSCAPE 
PORTRAIT
start in a certain orientation
noResettrue
false (default)
Don't reset app state before this session
fullResettrue
false (default)
Reset app state by uninstalling app. This will also remove the app after the session is complete

Note: This capability is optional. If not set and device is running a non-iOS OS, the Appium infrastructure will be used. For iOS devices, refer to this article to determine the infrastructure used.

Perfecto Extensions

General Settings

CapabilityValueDescription
autoInstrumenttrue
false (default)

To work with hybrid applications, install the iOS/Android application as instrumented.

When set to 'true' the iOS/Android application is instrumented before it is installed.

sensorInstrument

true
false (default)

To work with sensor input (for example fingerprint simulation, or image injection) install the iOS/Android application as instrumented.

When set to 'true' the iOS/Android application is instrumented before it is installed.

takesScreenshottrue (default)
false
Takes screenshots to display in the report. Relevant only if screenshotOnError is false.
screenshotOnErrortrue
false (default)
Screenshots for report are generated only for error conditions. This capability takes priority over the takesScreenshot capability.
scriptName The script report and report folder names.
Note: Script name should not include a blank character.
dataReset

true (default)
false

When re-installing an application all data associated with the application will be deleted and application will start with a clean slate. If set to false - data will not be deleted and the updated application will continue in the context of the existing data.
baseAppiumBehavior

YES
NO (default)

This capability selects whether to use the basic behavior of Appium in cases that Perfecto offers alternative behavior (may be expanded in the future with different behaviors):

YES – An element is considered visible if that element's frame is inside the screen frame and also the element is hittable.
NO - Default behavior (Perfecto) – An element is considered visible if that element's frame is inside the screen frame.

Android

CapabilityValueDescription
appActivity Activity name for the Android activity you want to launch from your package. This often needs to be preceded by a . (e.g.,.MainActivity instead ofMainActivity)
appPackage Java package of the Android app you want to run
appWaitActivity Activity name for the Android activity you want to wait for
appWaitPackage Java package of the Android app you want to wait for
intentAction(default 
android.intent.action.MAIN)
Intent action which will be used to start activity
intentCategory(default
android.intent.category.LAUNCHER)
Intent category which will be used to start activity
intentFlags(default 0x10200000)Flags that will be used to start activity
optionalIntentArguments Additional intent arguments that will be used to start activity. See Intent arguments

iOS 

CapabilityValueDescription
bundleId Bundle ID of the app under test. Useful for starting an app on a real device or for using other caps which require the bundle ID during test startup
processArguments Arguments to pass to the AUT using instruments

Appium Open Source capabilities

In addition, Perfecto supports the list of Appium server capabilities. To reference these, click here.