Zebrunner Device Farm (iOS slave)

• It is built on the top of OpenSTF with supporting iOS devices remote control.

Contents

• Software prerequisites
• iSTF components setup
• iOS-slave setup
• Setup sync scripts via Launch Agents for Appium, WDA and STF services
• License

Software prerequisites

• Install XCode 11.2+
• Install nvm version manager

  NVM required to organize automatic switch between nodes

• Using NVM install v8.17.0 and latest Appium compatible node version

  8.x node is still required by OpenSTF!

• Made latest node as default one for example: nvm alias default 14
• Sign WebDriverAgent using your Dev Apple certificate and install WebDriverAgent on each device manually
  • Open in XCode APPIUM_HOME/node_modules/appium-webdriveragent/WebDriverAgent.xcodeproj
  • Choose WebDriverAgentRunner and your device(s)
  • Choose your dev certificate
  • Product -> Test. When WDA installed and started successfully Product -> Stop
• Install ffmpeg for video recording capabilities brew install ffmpeg
• Install zeromq brew install zeromq
• Install cmake to be able to compile jpeg-turbo: https://cmake.org/install

iOS-slave setup

• Clone mcloud-ios repo

git clone --single-branch --branch master https://github.com/zebrunner/mcloud-ios.git
cd mcloud-ios

• Update devices.txt registering all whitelisted devices and simulators

# DEVICE NAME    | TYPE      | VERSION| UDID                                     |APPIUM|  WDA  | MJPEG | IWDP  | STF_SCREEN | PROXY_APPIUM
iPhone_7         | phone     | 12.3.1 | 48ert45492kjdfhgj896fea31c175f7ab97cbc19 | 4841 | 20001 | 20002 | 20003 |  7701      |  7702
Phone_X1         | phone     | 12.3.1 | 7643aa9bd1638255f48ca6beac4285cae4f6454g | 4842 | 20011 | 20022 | 20023 |  7711      |  7712

Specify unique port numbers per each service. Those ports should be accessible from MCloud master host

• Execute setup procedure

./zebrunner.sh setup

• Provide required arguments during setup

• Important! Everytime you create new Simulator(s) via XCode you have to run authorize-simulator command to authorize it and add new line into devices.txt to whitelist

./zebrunner.sh authorize-simulator

it is enough to run ./zebrunner.sh authorize-simulator command at once after generating multiply simulators

• Setup user auto-login for your current user to enable LaunchAgents load on reboot

License

Code - Apache Software License v2.0

Documentation and Site - Creative Commons Attribution 4.0 International License