Last updated: Feb 21, 2021 10:21
Prerequisites
The use of Appium Inspector with Perfecto requires Appium Desktop 1.12.0 or 1.17.0. We recommend the use of Appium Desktop 1.17.0. To download, go to https://github.com/appium/appium-desktop/releases/tag/v1.12.0 or https://github.com/appium/appium-desktop/releases/tag/v1.17.0.
To get started with Appium Desktop, follow the usage instructions at https://github.com/appium/appium-desktop.
Step-by-step instructions
1 | Open a device for testing and install the app
- In the Perfecto cloud, in the Manual Testing view, select the device you want to work with and click Open.
A new tab opens, showing the device screen with a device toolbar and a screenshot panel on the right. - On the device toolbar, click
to install an application. - In the Install application form, click ADD FILE, browse to the relevant application file, and click Open.
- Click INSTALL APP.
3 | Provide Perfecto credentials
- In the Appium Inspector window, click Select Cloud Providers, select Perfecto, and click Done.
- In the Perfecto Host field, enter your cloud information, such as
mobilecloud.perfectomobile.com
. Make sure to remove the following from the URL:
- Protocol identifier (such as http://
or https://
)
- .app
(if part of the URL) In the Perfecto Port field, type 80
.
In the Perfecto Token field, enter the security token you generated for your user.
If you have not generated a security token, click here for instructions

4 | Configure desired capabilities
In the Perfecto cloud, copy the device ID as follows:
On the device toolbar, click
to view device information.
- In the form that opens, on the DEVICE tab, copy the device ID.
In the Appium Inspector window, on the Desired Capabilities tab, add the deviceName
capability and paste the device ID into the Value field.
In the Perfecto cloud, on the device toolbar, click
to copy the session ID.
In the Appium Inspector window, on the Desired Capabilities tab, add the deviceSessionId
capability and paste the session ID into the Value field.
At this point, the JSON Representation should look similar to the following:
{
"deviceName": "9E705A94B8920BB61AE6842FA00E20FC8C12C231",
"deviceSessionId": "johnd@perforce.com_Interactivesession_19-10-24_15_08_15_19205"
}
- To connect Appium Inspector to the Perfecto device, click Start Session. The device screen appears in Appium Inspector.
5 | Inspect elements
When Appium Inspector has successfully connected with your Perfecto device, you can inspect the elements of your application:
- In Perfecto, open the relevant app and navigate to the screen you want to inspect.
- In Appium Inspector, refresh to view the device screen that is now open in Perfecto.
- Inspect elements as needed.
For more information on using Appium Inspector, see https://github.com/appium/appium-desktop/blob/master/README.md.
Limitations
Appium Inspector with Perfecto does not currently support:
- Hybrid apps
In particular, iOS 13 hybrid apps experience issues with pure Appium. - Automatic launch from Perfecto
- Smart Xpath
Troubleshooting
If you attempt to start a session and it hangs for a long time or times out, enter 80
into the Perfecto Port field (even if 80
is already indicated as the default port) and try again (in the Step-by-step instructions, under 3 | Provide Perfecto credentials, see step 3).