Mobile on Windows

Estimated reading time: 2 minutes

Katalon Studio Supported Environment on Windows

Unfortunately, you can only test an iOS application using macOS. If you wish to setup your macOS environment for Katalon Studio, please refer to this guide.

Appium 1.6, 1.7, 1.8
Android 6.x, 7.x

Installing Dependencies

Due to the diifferences in computer environments, the Katalon download package does not include some dependencies needed to test on mobile devices/emulators. Thus, in order to succesfully create and run a test case using Katalon Studio on Windows, you will need Appium.


  • Make sure you install Node.js into a location where you have full Read and Write permissions.
  • Appium 1.9 is not supported, so please kinldy install Appium 1.8.1 The installation command: npm install -g appium@1.8.1

Setting Up Your 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.In the Developer Options on Mobile User Interface, please enable:
  • USB debugging – Debug mode when USB is connected
  • Install via USB – Allow installing apps via USB
  • USB debugging (Security Setting) – Allow granting permissions and simulating input via USB debugging

  • 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.

Verifiying the Setup

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.

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 tutorial

User Contributed Notes