Skip to content

Commit 4ee5df6

Browse files
docs: Add a note about NovaDriver as a potential replacement (#318)
1 parent 97cf818 commit 4ee5df6

File tree

1 file changed

+11
-3
lines changed

1 file changed

+11
-3
lines changed

README.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,18 @@ Appium Windows Driver
88

99
Appium Windows Driver is a test automation tool for Windows devices and acts as a proxy to Microsoft's [WinAppDriver server](https://github.com/microsoft/WinAppDriver). Appium Windows Driver supports testing Universal Windows Platform (UWP), Windows Forms (WinForms), Windows Presentation Foundation (WPF), and Classic Windows (Win32) apps on Windows 10 PCs. The server itself is maintained by Microsoft at https://github.com/microsoft/WinAppDriver. Check its [release notes](https://github.com/microsoft/WinAppDriver/releases) and the [vendor documentation](https://github.com/microsoft/WinAppDriver/tree/master/Docs) to get more details on the supported features and possible pitfalls.
1010

11-
> **Note**
11+
> [!NOTE]
1212
>
1313
> Since version 2.0.0 Windows driver has dropped the support of Appium 1, and is only compatible to Appium 2. Use the `appium driver install --source=npm appium-windows-driver`
1414
> command to add it to your Appium 2 dist.
1515
16-
> **Note**
16+
> [!WARNING]
1717
>
18-
> This project is [actively looking for maintainers with DotNet experience](https://discuss.appium.io/t/winappdriver-and-dotnet-client-development-and-maintenance/40240).
18+
> WinAppDriver server has not been maintained by Microsoft for years.
19+
> Consider trying [NovaWindows Driver](https://github.com/AutomateThePlanet/appium-novawindows-driver)
20+
> by [Automate The Planet](https://www.automatetheplanet.com/) as a modern drop-in replacement for Appium Windows Driver.
21+
> Check the [Reviving Windows App Automation NovaWindows Driver for Appium 2](https://www.youtube.com/watch?v=mieajcgUn-k)
22+
> presentation video for more details.
1923
2024

2125
## Usage
@@ -409,6 +413,10 @@ Unfortunately we cannot do much about it from the Appium Windows Drive side. It
409413

410414
Eventually your best bet would be to report the issue to [WAD issues tracker](https://github.com/microsoft/WinAppDriver/issues) and hope there is some workaround for it as Microsoft has not been regularly maintaining the driver. If it turns out the issue is just a driver regression, and it was working properly in another WAD version, then you could always replace WAD binary supplied with Appium Windows Driver by default with a custom one. Simply fetch it from [Releases page](https://github.com/microsoft/WinAppDriver/releases) and install it locally. Ideally it should transparently replace the previously installed WAD and no further actions are expected. If that did not happen though, consider providing `APPIUM_WAD_PATH` environment variable pointing to the recently installed WAD binary path as described in [Environment Variables](#environment-variables) section.
411415

416+
You may also consider trying a compatible alternative for this driver:
417+
[NovaWindows Driver](https://github.com/AutomateThePlanet/appium-novawindows-driver),
418+
as mentioned at the beginning of this document.
419+
412420
## Development
413421

414422
```bash

0 commit comments

Comments
 (0)