Automated Testing with Emulators and Simulators

With Sauce Labs you can run automated tests against many virtual os and platform combinations with Android Emulators and iOS Simulators.

See the following sections for more topics:

What You'll Need

• A Sauce Labs Account.
• A mobile app you wish to test. If you don't have one, you can use the Sauce Labs sample mobile app.
  
  

Uploading Your Application to Emulators & Simulators

Before running your test you will need to upload either an Android package file (.apk) for emulators or an iOS package file (.zip) for simulators.

There are three ways you can upload your application for automated testing:

1. Sauce Application Storage
2. Install from a Remote Location
3. Legacy Sauce Storage

For detailed information on how to upload your application please visit Uploading your Application to Emulators and Simulators.

Running Your Test on Emulators & Simulators

After you've uploaded your application to a publicly available source, you must configure your test in order to run automated tests on Sauce Labs. How you configure your application depends on your testing use case:

Appium Tests

Below is some information with regards to running automated Appium tests on Emulators and Simulators.

Setting Appium Capabilities for Emulators and Simulators

Before you run your tests, you will need to configure the Appium capabilities in order to communicate with the Sauce Labs Virtual Devices.

DesiredCapabilities caps = DesiredCapabilities.iphone();
	caps.setCapability("appiumVersion", "1.13.0");
	caps.setCapability("deviceName","iPhone 8 Simulator");
	caps.setCapability("deviceOrientation", "portrait");
	caps.setCapability("platformVersion","12.2");
	caps.setCapability("platformName", "iOS");
	caps.setCapability("browserName", "");
	caps.setCapability("app", "https://github.com/saucelabs/sample-app-mobile/releases/download/2.2.0/iOS.Simulator.SauceLabs.Mobile.Sample.app.2.1.0.zip");

caps['browserName'] = ""
caps['appiumVersion'] = "1.13.0"
caps['deviceName'] = "iPhone 8 Simulator"
caps['deviceOrientation'] = "portrait"
caps['platformVersion'] = "12.2"
caps['platformName'] = "iOS"
caps['app'] = "https://github.com/saucelabs/sample-app-mobile/releases/download/2.2.0/iOS.Simulator.SauceLabs.Mobile.Sample.app.2.1.0.zip"

caps['browserName'] = '';
caps['appiumVersion'] = '1.13.0';
caps['deviceName'] = 'iPhone 8 Simulator';
caps['deviceOrientation'] = 'portrait';
caps['platformVersion'] = '12.2';
caps['platformName'] = 'iOS';
caps['app'] = 'https://github.com/saucelabs/sample-app-mobile/releases/download/2.2.0/iOS.Simulator.SauceLabs.Mobile.Sample.app.2.1.0.zip';

caps = Selenium::WebDriver::Remote::Capabilities.iphone()
caps['appiumVersion'] = '1.13.0'
caps['deviceName'] = 'iPhone 8 Simulator'
caps['deviceOrientation'] = 'portrait'
caps['platformVersion'] = '12.2'
caps['platformName'] = 'iOS'
caps['browserName'] = ''
caps['app'] = 'https://github.com/saucelabs/sample-app-mobile/releases/download/2.2.0/iOS.Simulator.SauceLabs.Mobile.Sample.app.2.1.0.zip'

DesiredCapabilities caps = new DesiredCapabilities();
	caps.SetCapability("appiumVersion", "1.13.0");
	caps.SetCapability("deviceName", "iPhone 8 Simulator");
	caps.SetCapability("deviceOrientation", "portrait");
	caps.SetCapability("platformVersion", "12.2");
	caps.SetCapability("platformName", "iOS");
	caps.SetCapability("browserName", "");
	caps.SetCapability("app", "https://github.com/saucelabs/sample-app-mobile/releases/download/2.2.0/iOS.Simulator.SauceLabs.Mobile.Sample.app.2.1.0.zip");

DesiredCapabilities caps = DesiredCapabilities.android();
	caps.setCapability("appiumVersion", "1.9.1");
	caps.setCapability("deviceName","Samsung Galaxy S9 Plus FHD GoogleAPI Emulator");
	caps.setCapability("deviceOrientation", "portrait");
	caps.setCapability("browserName", "");
	caps.setCapability("platformVersion","8.1");
	caps.setCapability("platformName","Android");
	caps.setCapability("app", "https://github.com/saucelabs/sample-app-mobile/releases/download/2.2.0/Android.SauceLabs.Mobile.Sample.app.2.2.0.apk");

caps = {}
caps['appiumVersion'] = "1.9.1"
caps['deviceName'] = "Samsung Galaxy S9 Plus FHD GoogleAPI Emulator"
caps['deviceOrientation'] = "portrait"
caps['platformVersion'] = "8.1"
caps['platformName'] = "Android"
caps['app'] = "https://github.com/saucelabs/sample-app-mobile/releases/download/2.2.0/Android.SauceLabs.Mobile.Sample.app.2.2.0.apk"

caps = {};
caps['appiumVersion'] = '1.9.1';
caps['deviceName'] = 'Samsung Galaxy S9 Plus FHD GoogleAPI Emulator';
caps['deviceOrientation'] = 'portrait';
caps['browserName'] = '';
caps['platformVersion'] = '8.1';
caps['platformName'] = 'Android';
caps['app'] = 'https://github.com/saucelabs/sample-app-mobile/releases/download/2.2.0/Android.SauceLabs.Mobile.Sample.app.2.2.0.apk';

caps = Selenium::WebDriver::Remote::Capabilities.android()
caps['appiumVersion'] = '1.9.1'
caps['deviceName'] = 'Samsung Galaxy S9 Plus FHD GoogleAPI Emulator'
caps['deviceOrientation'] = 'portrait'
caps['browserName'] = ''
caps['platformVersion'] = '8.1'
caps['platformName'] = 'Android'
caps['app'] = 'https://github.com/saucelabs/sample-app-mobile/releases/download/2.2.0/Android.SauceLabs.Mobile.Sample.app.2.2.0.apk'

DesiredCapabilities caps = new DesiredCapabilities();
	caps.SetCapability("appiumVersion", "1.9.1");
	caps.SetCapability("deviceName", "Samsung Galaxy S9 Plus FHD GoogleAPI Emulator");
	caps.SetCapability("deviceOrientation", "portrait");
	caps.SetCapability("browserName", "");
	caps.SetCapability("platformVersion", "8.1");
	caps.SetCapability("platformName", "Android");
	caps.SetCapability("app", "https://github.com/saucelabs/sample-app-mobile/releases/download/2.2.0/Android.SauceLabs.Mobile.Sample.app.2.2.0.apk");

Example Appium Scripts

Below are some links to sample repositories that contain sample scripts to get you started with automated testing on Sauce Labs.

Native Mobile Test Frameworks

Using Native Test Frameworks on Sauce Labs requires the Sauce Runner. Please visit the following pages for further information, example scripts, and demos using the Sauce Runner with native frameworks.

• Using Espresso for Virtual Device Testing
• Example Espresso Tests for a React-Native App on Virtual Devices
• Using XCUITest for Virtual Device Testing
• Example XCUITest Tests on for a React-Native App on Virtual Devices

Best Practices and Reporting Test Results

Now that you've been able to get a test running on Sauce, there are a few other modifications you can make to your tests. These example scripts show how to:

• Implement timeouts to control text execution times
• Add annotations
• Send Pass/Fail results to the Sauce Labs dashboard
• Use Build IDs and tags to differentiate and identify test runs

You can find more information under Best Practices for Running Tests and Setting Test Status to Pass or Fail.

Additional Topics

• Appium Capabilities for Emulator and Simulator Testing
• Configuring Appium Tests for Emulators and Simulators
• Uploading your Application to Emulators and Simulators