Setup for desktop app testing (Windows Apps Only)

This article contains instructions on how to set up desktop app testing for Windows desktop applications from testRigor cloud servers.

First and foremost, it's important to have access to a desktop computer with the application you want to test already installed. Most users prefer a virtual machine (VM) from an external provider because it is always on; however, it is also possible to use a local Windows computer. The following step work for either one, but keep in mind that a local Windows computer must be accessible via a reliable internet connection.

1. Enable Remote Desktop (RDP) for Windows.

Enable Remote Desktop in Windows settings. To do this, head to Windows Settings -> System -> Remote Desktop and switch Enable Remote Desktop to On.

2. Create Suite in testRigor

Once Remote Desktop is enabled on the Windows device being used for testing your application, it’s important to set up the connection with testRigor by providing the IPv4 address. To do this, click the Windows (or Start) > Settings > Network & Internet > Hardware Properties. The computer’s IPv4 address should be visible there. Copy that address and go to https://app.testrigor.com/home (you’ll have to log in if you have not already done so). Below New Test Suite, select Windows Remote Desktop from the Type of Testing dropdown, paste the copied IPv4 address into the Address field in the New Test Suite and provide the necessary credentials for testRigor to access the device.

If the computer is behind a VPN or firewall, access will need to be granted via tunneling. See documentation here.

3. Setup Microsoft Windows Application Driver (recommended).

Configure secure access from the testRigor servers to the local Microsoft Windows Application Driver (WinAppDriver). You can do this with a firewall (ask support for a list of testRigor server addresses) or by tunneling. To set up tunneling, contact the testRigor's support team. They will allocate a separate port number and help you set up the tunnel.

Download the latest stable release of Windows Application Driver installer (now this is WindowsApplicationDriver_1.2.1.msi) from the official homepage https://github.com/microsoft/WinAppDriver/releases/ and install it (administrator rights will be required).

Enable Developer Mode in Windows settings. To do this, head to Windows Settings -> Update & Security -> For Developers and enable Developer mode.

Run WinAppDriver.exe from the installation directory (e.g., C:\Program Files\Windows Application Driver\).If you want to change the listening address/port (http://127.0.0.1:4723 by default), you will need administrator rights to run it.

Specify a URL of the running WinAppDriver in the testRigor test suite settings. To do this, head to Settings -> Remote Desktop -> Windows Application Driver URL. For a configured tunneling it will look like http://tunnel.testrigor.com:XXXX, where XXXX is the port number from the tunneling configuration for the WinAppDriver.