Set up WinAppDriver in Katalon Studio
This document shows you how to install and run Windows Application Driver (WinAppDriver) on a Windows 10 machine before performing Windows Desktop Apps tests.
What is the test machine?
The test machine is where you have the Application Under Test installed and tested.
What is the test runner machine?
- The test runner machine is where you install Katalon Studio and store the test scripts.
- The test runner machine and the test machine can be the same machine or different ones (remote connection)
Install and run WinAppDriver on Windows 10 machine
Install and run WinAppDriver on the test machine.
There are two ways to install WinAppDriver on a Windows 10 machine:
From the Katalon Studio toolbar, select Tools > Windows > Install WinAppDrivers. The Windows Application Driver Setup window opens. Follow the instructions to install the Windows Application Driver.
You can also refer to the WinAppDriver Github project document here: Installing and Running Windows Application Driver for the installation.
Enable Developer Mode on the test machine. You can refer to the Microsoft document here: Enable your device for development for instructions.
By default, WinAppDriver is installed at
C:\Program Files (x86)\Windows Application Driver. To run WinAppDriver, double-click the
WinAppDriver.exefile from the installation directory.
Set up WinAppDriver for the remote connection
On the Windows 10 test machine
- While the test is being run, make sure to have WinAppDriver open and configured for the remote connection on the Windows 10 test machine.
After installing WinAppDriver and enabling Developer Mode, to configure WinAppDriver for the remote connection, follow these steps:
- Open Task Manager > Select File > Create a new task.
Select Create this task with administrative privileges and enter
cmdin the Open text box, then click the OK button.
cdto your WinAppDriver installation folder. By default, it is at
C:\Program Files (x86)\Windows Application Driver.
WinAppDriver.exe <IP_Adress> <Port>.
IP_Adress: is the public IP address of the test machine. Run
ipconfig.exeto determine the IP address.
Port: is the public port of the remote machine. By default, it should be 4723.
If the test machine is in a highly secured environment with firewall, you might need to create an Inboud Port Rule for the test machine to receive inbound requests. To set up the inbound rule, you can follow the steps here in the WinAppDriver project document: Create an Inbound Port Rule.
On the test runner machine
- The test runner machine can be Windows, macOS or Linux.
WinAppDriver URLpoint to the public IP address of the remote test machine. In the above example, it should be:
The application file path is the absolute path to the
Windows Executable File (*.exe) file of the remote test machine.