Moving Appium Test To Testdroid Cloud

To switch from using Appium on localhost to using Appium at Testdroid Cloud, a couple of minor changes in your test scripts need to be made.

Testdroid samples are available from Github. To continue environment should be set up as described here.

The addresses that are needed below are defined as such:


Step 0: Upload your app to Testdroid Cloud

The app has to uploaded to Testdroid Cloud via command line using a POST request.

POST: \<WebDriver\>/upload  
Authentication: Basic Auth  
Multipart: True  
Parameter Name: any  
Parameter Value: File (.ipa/.apk)  

You can also just upload the app using curl:

$ curl -s --user '' -F myAppFile=@"/path/to/app/file.apk"

or rather using the api key from under My account from the cloud:

$ curl -s --user <api key>: -F myAppFile=@"/path/to/app/file.apk"

Note, be sure to save the app identifier received as upload response. Let’s call it <myAppFile> in this guide.

Step 1: Select a device

Log into, select a device you want to run your tests on, and copy its name (example: iPhone 5c 7.0.4 A1532)

Step 2: Add Testdroid_ Desired Capabilities in your test script

Add the Testdroid_ Desired Capabilities in your TestScript. You would now need the <myAppFile> and the device name from the two previous steps to be placed as values against relevant Desired Capability.

Here is a comparison of how the Desired Capabilities part of the test script should look like before and after this Step.

Desired capabilities

Step 3: Change the WebDriver address

Point the WebDriver address to

Step 4: Run the Test Script

After making the above changes in your test script, you can proceed with running it exactly the same way as you would do with Appium Server running on your localhost.

Step 5 (optional): Upload your Test Suite output to Cloud

If your test suite generates a JUnit XML results file, you can upload the XML to Testdroid Cloud. Doing this will allow you to check your test cases and their run statuses on the Testdroid web UI, and let you download test reports in various formats.

  1. Add the testdroid_junitWaitTime Desired Capability in your TestScript.

  2. Get Appium sessionId from your script (after the WebDriver connection has been established) using: driver.session_id()

  3. After your test run has finished, and JUnit XML has been generated, use Curl to upload the XML to Cloud:

     curl -s -F result=@"/absolute/file/path/TestOutput.xml"<sessionId>

Step 6: Get results from Cloud

Get the screenshots, Appium.log and Logcat (Android) or Trace (iOS) output from