XCUI Supported Capabilities

Real Device Virtual Device

This document provide details about the features and capabilities supported for XCUI Framework on LambdaTest.

The capabilities listed in this document are also supported for Virtual Devices

Capability Name	Data Type	Description
app Real Device Virtual Device	String	Enter the app id generated while uploading the app to the platform. Example:lt://APP123456789123456789
testSuite Real Device Virtual Device	String	Enter the test suite id generated while uploading the test suite to the platform. Example: lt://APP123456789123456789
device Real Device Virtual Device	String	Enter the device name and os version in DeviceName-OSVersion format. Example: "device" : ["Galaxy S20-10","Pixel 3 XL-9"]
video Real Device Virtual Device	Boolean	When you pass the video: true, it will generate the video for all the tests that are executed.
queueTimeout Real Device Virtual Device	Integer	Enter the time in seconds after which you want your build to timeout from queue. Example: queueTimeout: 300
idleTimeout Real Device Virtual Device	Integer	Enter the time in seconds for maximum running time of a test in a build. Example: idleTimeout: 120
deviceLog Real Device Virtual Device	Boolean	To generate the device logs, pass the value as deviceLog: true
network Real Device Virtual Device	String	To generate the network logs, pass the value as network: true.
build Real Device Virtual Device	String	To set the Espresso build name. Example: build: My Espresso Build.
geoLocation Real Device	String	Set the geolocation country code if you want to enable the same in your test. Example: geoLocation: FR
gpsLocation Real Device Virtual Device	Decimal	The capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: "location": {"lat": "-50","long": "150.028333"}.
tunnel, tunnelName Real Device Virtual Device	Boolean	To activate the tunnel mode, pass the value as tunnel: true and provide the name of your tunnel as tunnelName: NewTunnel
enableBluetooth Real Device	Boolean	Used to enable the bluetooth functionality during the session. Example: enableBluetooth: true
resignApp Not supported in Virtual Devices	Boolean	Set this to false if you want to to prevent the apps from being re-signed. The app should be built for enterprise distribution.
testRemarks Real Device	Boolean	Set to true to surface failure remarks at the top of the dashboard when a test fails. Has no effect on passing tests. Default: false.
retries Real Device	Integer	Defines the number of times a test should automatically retry if it fails. Maximum allowed value: 5.

note

Ensure that the latitude is between -90 and 90, and the longitude is between -180 and 180. Otherwise, an error will occur like "Invalid GPS location: Latitude must be between -90 and +90, Longitude must be between -180 and +180."