NOTE:
This project is not maintained by Sauce Labs anymore

JS-Grunt-Mocha-Parallel-Appium-iOS

This code is provided on an "AS-IS” basis without warranty of any kind, either express or implied, including without limitation any implied warranties of condition, uninterrupted use, merchantability, fitness for a particular purpose, or non-infringement. Your tests and testing environments may require you to modify this framework. Issues regarding this framework should be submitted through GitHub. For questions regarding Sauce Labs integration, please see the Sauce Labs documentation at https://wiki.saucelabs.com/. This framework is not maintained by Sauce Labs Support.

Environment Setup

1. Global Dependencies
   • Install Node.js
   • Or Install Node.js with Homebrew

   $ brew install node
   

2. Sauce Credentials
   • In the terminal export your Sauce Labs Credentials as environmental variables:

   $ export SAUCE_USERNAME=<your Sauce Labs username>
   $ export SAUCE_ACCESS_KEY=<your Sauce Labs access key>
   

3. Project Dependencies
   • Install Node modules

   $ npm install
   

4. Test Targets
   • Simulator app: GuineaPig-sim-debug.app.zip located in /resources
   • Device app: GuineaPig-dev-debug.app.zip located in /resources
   • App names and paths are defined in Gruntfile.js and helpers.js in the test folder.

Running Tests

• Tests in Parallel:

   $ npm test
  

Sauce Labs Dashboard

Advice/Troubleshooting

1. There may be additional latency when using a remote webdriver to run tests on Sauce Labs. Timeouts or Waits may need to be increased.
   • Selenium tips regarding explicit waits

Resources

Sauce Labs Documentation

Appium Documentation

WD.js Documentation

Node Documentation

Mocha Documentation

Grunt Documentation

Stack Overflow

• A great resource to search for issues not explicitly covered by documentation