Mobile on macOS

Estimated reading time: 3 minutes

Katalon Studio Supported Environment on macOS

  • Appium: 1.12.1 onwards
  • Android: 6.x onwards
  • iOS: 9.x onwards


Some emulators have already supported Appium through their installations. Thus, if you want to run an application on an emulator, check you emulator's settings before proceeding with Appium installation.


Required components

If you want to test an Android application on your local device. You will need to install Appium. The basic steps are:

  • Install NodeJS

  • npm install -g appium

Setting up the devices

  • Turn on the phone's developer mode (go to SettingsDeveloper options).
  • Connect your Android Phone to your computer via a USB cable. Just confirm if prompted to accept/trust the device.
  • Install Android SDK: Katalon Studio will detect and ask you to install Android SDK automatically if your current machine doesn't have it. Please allow Katalon Studio to install it in this case.


After completing setting your environment, open a Mobile Testing Sample Project (which is packaged in your Katalon Studio installation) and execute a test suite using an Android device: 

Select your device from the Android Devices list. Click OK

If your test suite runs successfully, you will see the results in the test reports as follow:

For more information on how to run a test suite, check out the documentation here.


Required components

  • Appium v1.12.1 or newer
  • Xcode 10.2 or newer
  • Command line tool for Xcode
  • Carthage 0.33 or newer
  • ios-deploy 1.9.4 or newer
  • ios-webkit-debug-proxy 1.8.4 or newer
  • libimobiledevice 1.2.0 or newer
  • usbmuxd 1.0.10 or newer
  • WebDriverAgent

Reference installation guide

We recommend you to refer to the official documentation of each component for the detailed instructions.

Install Xcode

Xcode can be install via Mac App Store.

Install Xcode command line tool

Please follow this link:

Install appium

  • Install NodeJS.

  • npm install -g appium

Install homebrew

Please follow this link:

Install carthage

brew install carthage

Install ios-deploy

brew install ios-deploy

Install usbmuxd

brew install --HEAD usbmuxd brew unlink usbmuxd brew link usbmuxd

Install ios-webkit-debug-proxy

brew install ios-webkit-debug-proxy

Install libimobiledevice

brew install --HEAD libimobiledevice brew unlink libimobiledevice brew link libimobiledevice

Install WebDriverAgent

Please follow these links:

Additionally, if you want to test iOS applications, you will need to download the packages below (which have been linked to their respective setting up instructions):

Setting up the devices

Connect your iOS Devices to your computer via a USB cable. Just confirm if prompted to accept/trust the phone.

If you want to execute your tests using Safari on iOS (mobile browser), make sure Web Inspector is turned on for Safari (Settings → Safari → Advanced → Web Inspector)

Enable the service UI automation on the device.

Connect the iOS device to Xcode.

Settings on the iOS device > Developer > turn ON UIAutomation

Verify the mobile app file

Before testing an iOS native application file (.ipa file), follow these steps to check if the application file is already built and signed correctly.

Open Xcode and navigate to Window/Devices

Choose your device from the Devices list.

Press the "+" button and choose you application file.

If installed successfully, the application will appear in the Installed Apps section as shown below.

Finishing Steps

Once setting up successfully, follow the following guides to perform mobile testing in Katalon Studio

Troubleshooting Common Issues

Please refer to this troubleshooting article.

User Contributed Notes