Inspect your app elements and interact with them on BrowserStack’s real devices using Appium Desktop.
Appium Desktop is an open-source app for Mac, Windows, and Linux which gives you the power of the Appium automation server in a flexible UI. It is a combination of a few Appium-related tools:
BrowserStack’s integration with Appium Desktop allows you to try the inspector on real Android and iOS devices. Download the latest release of Appium Desktop from the Appium Desktop Github page.
Follow the steps below to use BrowserStack with Appium Desktop:
Step 1: Upload your app
Upload your Android app (.apk
file) or iOS app (.ipa
file) to the BrowserStack servers using the REST API. Here is an example cURL
request to upload your app using our REST API :
curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/upload" \
-F "file=@/path/to/app/file/app-debug.apk" \
Here is an example REST API response :
{
"app_url":"bs://f7c874f21852ba57957a3fdc33f47514288c4ba4",
}
Please note the value of app_url
in the REST API response (bs://f7c874f21852b....
in the above example). This value will be used later to set the app
capability.
Step 2: Start new session window on Appium Desktop
Follow the instructions on Appium Desktop GitHub page to start a new session window. Select BrowserStack
from the list of cloud providers.
Step 3: Configure BrowserStack credentials on Appium Desktop
On the new session window, enter your BrowserStack username
and access key
. Obtain these credentials from BrowserStack’s Account Settings page.
Step 4: Configure desired capabilities and start session
Configure BrowserStack capabilities in the Desired Capabilities tab on Appium Desktop. Use the app_url
value obtained in step 1
to set the app
capability value. You also need to set the device
value. Refer to Capabilities reference page for a list of all supported capabilities.
On successful connection with the BrowserStack device, you will be able to inspect elements of your app and record the session using the BrowserStack device on the cloud. You can open the App Automate Dashboard to access test details.
Using Appium Desktop with BrowserStack makes it very convenient for you to inspect your app elements and write the automation tests for your app.
Contact our Support team for immediate help while we work on improving our docs.
Contact our Support team for immediate help while we work on improving our docs.