Set Up Appium

The Commerce Cloud Endless Aisle app is instrumented to use Appium to run automated tests.

To be able to run Appium to test the app:

To set up the tests and install Appium:

  1. Rename Endless-Aisle-Test/tests/helpers/app.js.sample to app.js.
  2. Edit app.js to point to your app path.
  3. Copy Endless-Aisle-Test/tests/package.json and paste it into your top level home directory (/Users/<yourname>).
    Note: If you are using the desktop version, start the Appium server by launching the desktop version and clicking Start Server. With this method you need only one open terminal.
  4. In a terminal, enter the following: sudo npm cache clean -f
  5. If you need to install npm, enter sudo npm install.
  6. Make the directory where you copied package.json the current directory.
  7. In a terminal enter each of the following:
    • sudo npm install mochawesome-screenshots
    • sudo npm install -g n
    • sudo n 8.9.3
    • node -v

      You should have 8.9.3 installed.

    • npm -v

      You should have 4.0.0 or above installed.

    • sudo npm install appium -g
    • sudo chmod 777 /var/db/lockdown
    • sudo npm install appium
    • appium -v

      You should have Appium 1.6.3 installed.

    • sudo chown -R $USER /usr/local
    • cd node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent/
  8. If you don't already have Homebrew installed, enter: /usr/bin/ruby -e "$(curl -fsSL"
  9. In a terminal, enter:
    • brew install carthage
    • ./Scripts/ -d
Note: For an alternative to installing Appium via the command line, go to and download version 1.6.3 or above.

Related Links

Run Tests in Appium

Modify and Create Automated Tests