The Sauce Labs Cookbook

Sauce Headless

Front End Performance Testing


External Resources

More Info

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

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

Please select your preferred platform UI:

Table of Contents

Uploading an Application from the Sauce Labs UI

You can test your mobile applications on a variety of real Android and iOS mobile devices with App Upload on Sauce Labs.

  1. Log in to Sauce Labs and go to Live Tests > Mobile-App
  2. At the top of the page you will see the name of the last app you tested. Click Change to select a different app.
  3. Select App Upload to upload an app to test 

  4. You can either drag and drop an application or browse for file.
  5. Please note that the app needs to be an APK or IPA file
  6. If you are looking for old apps that you have previously uploaded or if you want to create a new real device project. Please click the link at the bottom of the page 'Looking for Old Repository'. This will re-direct you to the old App Management UI with all your previously uploaded apps.

Running Real Devices Tests on Sauce Labs

Sauce Labs has unified the Sauce Labs Virtual Platform ( and Sauce Labs Legacy Real Device Platform (, under one platform -, allowing customers to use the best of both worlds, Virtual Platforms like Emulators and Simulators, Desktop Web and Real Devices, under one unified platform, including shared APIs, endpoints, reporting, secure tunnels, analytics, etc.

Supported Use Cases for Real Devices on Sauce Labs (RDC on Sauce)

The following use cases are support in Phase 1:

  • You would like to execute Appium tests against a private real device hosted in the US, using your Sauce Labs username and access key

  • You would like to use Sauce Storage, for Appium testing, as you usually do for Emulators and Simulators tests

  • You would like to analyze Appium test executions, on Sauce Labs Dashboard (Dashboard / Automated Tests), similar to the way you do it for Desktop and Emulators and Simulators

  • You would like to consume Real Device Cloud (RDC) API similar to the way you do for Emulators and Simulators (with applicable RDC settings)

RDC on Sauce Labs Endpoints

RDC on Sauce Examples

Unified Platform Appium Testing Example
private URL createUrl() throws MalformedURLException {
    return new URL("https://$SAUCE_USERNAME:$");
void setUp() throws MalformedURLException {
    DesiredCapabilities desiredCapabilities = new DesiredCapabilities();
    desiredCapabilities.setCapability("platformName", "iOS");
    IOSDriver driver = new IOSDriver(createUrl(), desiredCapabilities);

RDC on Sauce API

Learn more here.

Table of Contents

In this article, we'll cover how to create and configure a new Real Device Cloud test project for your app. 

Uploading an Application to the TestObject Platform

When you create a project, you'll need to provide information about the website or app you want to test, and the device settings you want to use in your tests. You can also create versions of the project to reflect changes in the app or website throughout your development process. 

  1. Log into Sauce Labs, then click SAUCE APPS > Legacy RDC.
  2. Click the New App button.

  3. Choose the type of app you'd like to create. You can choose from an Android/iOS App project, a Mobile Website test project, or an Install Remote app (see App Center Integration for more info). For this example, we'll select Android/iOS App.

  4. Click Choose File, browse to the file containing your app, and upload it. 

    To view and download sample apps for iOS and Android, head to the Sauce Labs sample app page on GitHub

  5. Input your app name and version, then click Save.

  6. Edit the Device Settings as needed, then click Save.

Accessing Setup Instructions (Appium Test Automation Framework)

  1. Log into Sauce Labs, then click SAUCE APPS > Legacy RDC > select your app > AUTOMATED TESTING > Appium.

  2. Click Setup Instructions.

  3. Once you've created your app project (Uploading an Application), the setup instruction will prompt you to input required test script information:
    • API Key as desired capability

    • Data Center URL to be used as your WebDriver Hub URL

    • If you want to test on a specific mobile device – static device allocation – you'll need to provide the ID for that device. If you'd like to test on a broader array of devices – dynamic device allocation – you can specify your criteria via WebDriver desired capabilities (e.g., all Android devices with OS 9).

      To read more about Dynamic vs. Static Device Allocation, see Dynamic Device Allocation.

Versioning Real Device Projects with Test Object

Once you've created a real device project, you can create versions of it. Each of these versions will be stored in your project, and you can run tests against the current Active version, or a previous version. 

  1. Log into your account.
  2. In the Apps dashboard, select your project.

    When the project loads, you'll see an Active Versions panel. This provides information about the current version of the project.

    You can also:
    1. Click Upload New Version to add a new version of the application if this is a mobile application project.

    2. Click  Upload New URL to change the URL for a mobile website project.
    3. Click All Versions to view and select a version of your project to run your tests against. This will also change the current Active Version of the project. 

  • No labels