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

X Privacy Update: We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used. By continuing to use this site you are giving us your consent to do this. Privacy Policy.