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

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.