WinAppDriver – Free Tool To Automate Windows Applications

 WinAppDriver

WinAppDriver (short for Windows Application Driver) is a free test automation tool for Windows desktop apps developed by Microsoft. It can run as a standalone as well as a plugin for Appium. Thus, if you are already running Appium’s server, then a request for Win10 app automation will launch WinAppDriver.exe, one of the fast-growing tools that will provide you with better support for using Appium to test Windows apps.

Appium is cross-platform it allows you to write tests against multiple platforms (iOS, Android, Windows), using the same API. This enables code reuse between iOS, Android, and Windows test suites



Supported Applications 

It is supported on machines running Windows 10 operating system (Home and Pro) and Windows Server 2016, and it supports all Windows applications based on:

Universal Windows Platform (UWP), Windows Forms (WinForms), Windows Presentation Foundation (WPF), and Classic Windows (Win32) apps

Configurations

  1. Download Windows Application Driver installer from here
  2. Enable Developer Mode in Windows settings (shown in below image)
  3. Run WinAppDriver.exe from the installation directory (E.g. C:\Program Files (x86)\Windows Application Driver)

Windows Application Driver will then be running on the test machine listening to requests on the default IP address and port (127.0.0.1:4723).  



Inspect a Windows UI Element

To start inspecting a windows UI element, we need the Windows kit which can be downloaded from here

The latest version of Microsoft’s Visual Studio includes the Windows SDK by default along with the Inspect tool to inspect the application under test. This tool shows every UI element/node which can be queried using the Windows Application Driver. 


The inspect.exe tool can be found under the Windows SDK folder which is typically

C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64


In this example, I am inspecting the elements of the Alarms & Clock application



Note: An alternate of inspect.exe we can use the UiSpy from here - Download UiSpy


Writing the Script

With WinAppDriver you can use any of the following languages C#, Java, JavaScript, Python, Ruby In this example, I’ve to use Java with TestNG. Below is the code I used to launch the session to the Calculator application:

Note: Make sure the winappdriver.exe is running, once the connection is established you can see all the comminutions in winappdriver.exe console

@Test

public void launchCalculator() throws MalformedURLException {

DesiredCapabilities capabilities = new DesiredCapabilities();

capabilities.setCapability("app","Microsoft.WindowsCalculator_8wekyb3d8bbwe!App");

capabilities.setCapability("platformName", "Windows");

capabilities.setCapability("deviceName", "WindowsPC");

CalculatorSession = new WindowsDriver(new URL("http://127.0.0.1:4723"), capabilities);

CalculatorSession.manage().timeouts().implicitlyWait(10,TimeUnit.SECONDS);

}

Locators

Windows Application Driver supports various locators to find UI element in the application session. The table below shows all supported locator strategies with their corresponding UI element attributes shown in inspect.exe


Supported Capabilities

Below are the capabilities that can be used to create Windows Application Driver session


References

·         WinAppDriver GitHub - GitHub

·         Saravanan Seenivasan GitHub - Saravanan Seenivasan GitHub

·         Saravanan Seenivasan YouTube - YouTube

·         WinAppDriver With WDIO - WinAppDriver-WDIO


Thanks
Saravanan Seenivasan
QA Lead Engineer



Comments

Post a Comment

Popular posts from this blog

Create A REST API With JSON Server

Image
In the following will learn how to setup JSON Server and publish a sample REST API Most of the time we will not get the flexible dummy REST API end points to practice or learn to validate the CRUD operations, we have an option to create full fake REST API with zero coding Reference Installing JSON Server JSON Server is available as a NPM package, The installation can be done by using the Node.js package manager, since we are going to use NPM packages we required Node.js to be installed before moving further Install Node.js - download the Node.js and install as per your system requirements (Download Node.js here)  and confirm the Node.js is installed successfully on your system as per following the steps shown below  Install JSON Server - We will install JSON Server now using the NPM package, run the below in command prompt    npm install json-server (or) npm install -g json-server **  by adding -g option we make sure the package is installed globally on our...
Read more

Change The Default Port Number Of JSON-Server

Image
In my previous blog we have seen how to create a REST API with JSON Server, if you missed please have a look at here  Link And whenever we start the JSON Server it is running on http://localhost:3000 , mean its running in your localhost and the port number is 3000 , In this blog we will see how to change the port number from 3000 to another port (xxxx) incase something you are running already on 3000 Please refer here how to setup the JSON Server on your machine -  Link Once we are done with the setup and if you want to start the JSON Server in different port then we have to run this command in terminal to start the JSON Server Usually we use this command to start JSON Server which will run the server on 3000 port json-server data.json Start the JSON Server in different port Instead of running the above command we have additionally pass the port parameter value to start in particular port as per your need json-server -p 4000 data.json And now you can open the  URL ...
Read more
Image
  Shift-Left Development Process   What is shift-left? Shift Left is a practice intended to find and prevent defects early in the software delivery process. The idea is to improve quality by moving tasks to the left as early as the lifecycle. Shift Left testing means testing earlier in the software development process. “Start Testing activities as early as possible in the development life cycle. Test Early and Often” How does it differ from our traditional model? A typical waterfall software development project would have seen testing occur immediately prior to release into production. This meant that when bugs or usability issues were inevitably found, the release would be delayed until these were fixed. Why Shift Left? In the traditional software development model, requirements are kept on the left side of the plan, and the delivery and testing requirements are on the right. The problem is that these practices can’t handle changing expectations and requiremen...
Read more