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:

• Ensure that you are running.
  Note: For specific versions, see the README.md file in the Endless Aisle app code.
  • macOS X
  • XCode - Ensure you have the command line tools for XCode for the OS you are running.
  • iOS Simulator
• If you do have not already cloned the Endless-Aisle-Test repository to your local machine, available on GitHub, clone it. Switch to the appium16 branch by entering: git checkout master. To ensure you have the most recent updates enter: git pull

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 https://raw.githubusercontent.com/Homebrew/install/master/install)"
9. In a terminal, enter:
   • brew install carthage
   • ./Scripts/bootstrap.sh -d