Installing WebDriverAgent for iOS devices

Estimated reading time: 1 minute

This setup process is NOT required if you use Android devices. Please go straight to this step instead.

WebDriverAgent is a WebDriver server implementation for iOS that can be used to remote control iOS devices. You need to install and setup WebDriverAgent to allow Katalon Studio to automate iOS devices.

  • Open Xcode > Preferences > Accounts and add developer's Apple ID.

  • Open Terminal and enter following command to initialize WebDriverAgent project:
cd /usr/local/lib/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent
mkdir -p Resources/WebDriverAgent.bundle
sh ./Scripts/bootstrap.sh -d

Common issues

  • Error code 13: re-run command with sudo: sudo ./Scripts/bootstrap.sh -d

  • Error _Error StackTrace: Cannot find module 'eslint-config-appium': _missing paramter -d when running ./Scripts/bootstrap.sh

  • Login to Apple developer account and register device to developer account.

  • Open project WebDriverAgent.xcodeproj within folder WebDriverAgent in Xcode.

  • Select target WebDriverAgentLib, in the Signing section, check Automatically manage signing and select the team.

  • Then on the menu bar, select Product > Build

  • Repeat the last two steps for WebDriverAgentRunner

  • Xcode may fail to create a provisioning profile for the WebDriverAgentRunner target:

    Xcode provisioning fail

  • This necessitates manually changing the bundle id for the target by going to the Build Settings tab, and changing the Product Bundle Identifier from com.facebook.WebDriverAgentRunner to something that Xcode accepts, for example, "io.appium.WebDriverAgentRunner".

    Xcode bundle id

User Contributed Notes