As of now, there are only 2 ways to Live Test an app on an emulator/simulator on Sauce Labs:
Option 1: Start an automated test with the "app" capability pointing to the app in Sauce Storage (instructions here) and take manual control:
a) Upload your application into Sauce Storage using cURL commands. Please be aware that applications uploaded into Sauce Storage will be deleted after 7 days, at which point you will have to re-upload the application.
For Mac:
$ curl -F 'payload=@/Users/<user-name>/Downloads/<file_name>.apk' -F name=<file_name>.apk -u "$SAUCE_USERNAME:$SAUCE_ACCESS_KEY" 'https://api.us-west-1.saucelabs.com/v1/storage/upload' |
For Windows (here are some instructions on how to use cURL for Windows):
> curl -F "payload=@\Users\%SAUCE_USERNAME%\Downloads\<file_name>.apk" -F name=<file_name>.apk -u "%SAUCE_USERNAME%:%SAUCE_ACCESS_KEY%" 'https://api.us-west-1.saucelabs.com/v1/storage/upload' |
(If you're using our European Data Center, please use eu-central-1.saucelabs.com/rest/v1/storage.
)
b) Start an automated test (temporarily) and then take manual control in order to do your Live Test:
Include the "app" capability in your tests, or your test won't know which app to use and will fail. ("app","storage:filename=myapp.zip" or "app","storage:<fileID>"
) Examples of automated tests can be found here to help you get started. Click on the test in the automated tests tab while the test is running, and you will see a "Pause" button. Click that, and you will have manual control and will be able to do your live test. We have some example frameworks here that you can use to achieve this option. Just make sure you find a repository that uses Appium, such as this one. To ensure you have enough time to navigate to the running test and take manual control, it would be easiest to simply comment out the driver.quit()
command, which should leave the test running for 90 seconds.
Option 2: (At the moment, this appears to work for Android apps only)Add ?Raw=True
to a GitHub hosted app's URL & put this URL as the site under test in the URL field under Live --> Cross-Browser testing page to make it automatically download the app to the emulator:
PLEASE NOTE: If you do not want to publicly host your application, Option 1 would be the ONLY way for you to Live Test your app.
Please try one of these two options, as this is currently the only way to achieve a live test of an application with an emulator/simulator. If you still have questions, feel free to reach out to us at help@saucelabs.com