Script Execution on Sauce Labs: Configuration Guide

This guide explains how to configure Qualitia Automation Studio (QAS) to execute mobile scripts on Sauce Labs.
It includes prerequisites, setup, and execution steps to help even new users run their first mobile test successfully.

📚Prerequisites

Before starting, ensure you have the following:

1. Qualitia Setup

   • Qualitia Automation Studio installed and licensed.

   • Access to Qualitia Server with your project configured.

2. Sauce Labs Account

   • A valid Sauce Labs account with Username & Access Key.

   • Access to Sauce Labs UI (https://app.saucelabs.com).

Sauce Labs Setup

Retrieve Sauce Labs Credentials

1. Login to Sauce Labs: https://app.saucelabs.com.

2. Navigate to Account > User Settings.

3. Copy the following details:

   • Username

   • Access Key

   • Ondemand URL

These will be required when creating the Execution Profile in Qualitia.

Upload Mobile App to Sauce Labs

1. Login to Sauce Labs.

2. In the left-hand navigation, click App Management. Sauce Labs Documentation+1

3. On the App Management page, click Upload App (or New Upload) and do one of the following:

   • Drag & drop your .apk or .ipa file.

   • Browse and select the file from your local machine.

4. Once uploaded, your app build appears under App Builds. From here you can view details, Start Test (Live), or open the build to copy its storage reference. Refer Sauce Labs Documentation for more details.

5. Copy the storage reference of the app. Sauce Labs may show it in either format (both are supported):

   • storage:<fileId>

   • storage:filename=<your_app.apk>

Configuring Qualitia for Sauce Labs

Create/Update Execution Profile in Qualitia

• Open Qualitia Automation Studio.

• Go to Execute > Execution Profile.

• Create a new profile (e.g., SauceLabs_Android) or update an existing one.

Set Desired Capabilities for Sauce Labs Under Mobile Execution Platform

For Sauce Labs execution, add the following key Appium capabilities:

• URL – Sauce Labs Ondemand URL.

• username – Sauce Labs account username.

• accesskey – Corresponding Sauce Labs access key.

• appium:deviceName – Name of the device to be used for execution.

• appiumVersion – Version of Appium provided by Sauce Labs.

• appium:automationName – Automation engine (e.g., UiAutomator2 for Android, XCUITest for iOS).

Set Desired Capabilities for Sauce Labs Under Mobile > Android/iOS

• Select Appium Option - Custom.

• Appium Server URL - Sauce Lab Ondemand URL

• appium:platformVersion - android/iOS OS version

Executing Tests on Sauce Labs

1. In Qualitia, select the created Sauce Labs Execution Profile.

2. Trigger the mobile test execution.

3. Qualitia will connect with Sauce Labs using the provided credentials and capabilities.

4. The test will run on the selected virtual mobile device.

Monitoring Execution on Sauce Labs

1. Login to https://app.saucelabs.com.

2. Go to Automated > Test Results.

3. Select your latest execution to view:

   • Live video stream of the test execution.

   • Device logs, Appium logs, and screenshots.

   • Pass/Fail status with detailed execution history.

Common Issues & Resolutions

💡 Golden Nuggets: Best Practices

• Always use the latest stable Appium version supported by Sauce Labs.

• Re-upload the app for every new build and update its storage path in Qualitia.

• Regularly check Sauce Labs logs for errors and debugging.

• Choose real devices or emulators based on your test scenario needs.