doc/devdocs/modules/fancyzones.md

# FancyZones UI tests

UI tests are implemented using [Windows Application Driver](https://github.com/microsoft/WinAppDriver).

## Before running tests

  - Install Windows Application Driver v1.2.1 from https://github.com/microsoft/WinAppDriver/releases/tag/v1.2.1. 
  - Enable Developer Mode in Windows settings

## Running tests
  
  - Exit PowerToys if it's running
  - Run WinAppDriver.exe from the installation directory. Skip this step if installed in the default directory (`C:\Program Files (x86)\Windows Application Driver`); in this case, it'll be launched automatically during tests.
  - Open `PowerToys.sln` in Visual Studio and build the solution.
  - Run tests in the Test Explorer (`Test > Test Explorer` or `Ctrl+E, T`). 

>Note: notifications or other application windows, that are shown above the window under test, can disrupt the testing process.


## Extra tools and information

**Test samples**: https://github.com/microsoft/WinAppDriver/tree/master/Samples

While working on tests, you may need a tool that helps you to view the element's accessibility data, e.g. for finding the button to click. For this purpose, you could use [AccessibilityInsights](https://accessibilityinsights.io/docs/windows/overview) or [WinAppDriver UI Recorder](https://github.com/microsoft/WinAppDriver/wiki/WinAppDriver-UI-Recorder).

>Note: close helper tools while running tests. Overlapping windows can affect test results.
dev docs 2023-10-27 17:42:10 +02:00			`# FancyZones UI tests`
Devdocs reorganisation (#913) * docs: split usage and dev docs * # This is a combination of 2 commits. # This is the 1st commit message: docs: split usage and dev docs # The commit message #2 will be skipped: # fixup add docs * docs: add runner documentation and move hooks documentation to devdocs * docs: add stubs for modules technical description * docs: add paragraph about event thread-safety * docs: add 'Current modules' section header 2019-12-12 12:25:19 +03:00
dev docs 2023-10-27 17:42:10 +02:00			`UI tests are implemented using [Windows Application Driver](https://github.com/microsoft/WinAppDriver).`
Devdocs reorganisation (#913) * docs: split usage and dev docs * # This is a combination of 2 commits. # This is the 1st commit message: docs: split usage and dev docs # The commit message #2 will be skipped: # fixup add docs * docs: add runner documentation and move hooks documentation to devdocs * docs: add stubs for modules technical description * docs: add paragraph about event thread-safety * docs: add 'Current modules' section header 2019-12-12 12:25:19 +03:00
dev docs 2023-10-27 17:42:10 +02:00			`## Before running tests`
Devdocs reorganisation (#913) * docs: split usage and dev docs * # This is a combination of 2 commits. # This is the 1st commit message: docs: split usage and dev docs # The commit message #2 will be skipped: # fixup add docs * docs: add runner documentation and move hooks documentation to devdocs * docs: add stubs for modules technical description * docs: add paragraph about event thread-safety * docs: add 'Current modules' section header 2019-12-12 12:25:19 +03:00
update docs 2024-03-18 22:09:32 +01:00			`- Install Windows Application Driver v1.2.1 from https://github.com/microsoft/WinAppDriver/releases/tag/v1.2.1.`
dev docs 2023-10-27 17:42:10 +02:00			`- Enable Developer Mode in Windows settings`
Devdocs reorganisation (#913) * docs: split usage and dev docs * # This is a combination of 2 commits. # This is the 1st commit message: docs: split usage and dev docs # The commit message #2 will be skipped: # fixup add docs * docs: add runner documentation and move hooks documentation to devdocs * docs: add stubs for modules technical description * docs: add paragraph about event thread-safety * docs: add 'Current modules' section header 2019-12-12 12:25:19 +03:00
dev docs 2023-10-27 17:42:10 +02:00			`## Running tests`

update docs 2024-03-18 22:09:32 +01:00			`- Exit PowerToys if it's running`
			- Run WinAppDriver.exe from the installation directory. Skip this step if installed in the default directory (`C:\Program Files (x86)\Windows Application Driver`); in this case, it'll be launched automatically during tests.
dev docs 2023-10-27 17:42:10 +02:00			- Open `PowerToys.sln` in Visual Studio and build the solution.
			- Run tests in the Test Explorer (`Test > Test Explorer` or `Ctrl+E, T`).
Devdocs reorganisation (#913) * docs: split usage and dev docs * # This is a combination of 2 commits. # This is the 1st commit message: docs: split usage and dev docs # The commit message #2 will be skipped: # fixup add docs * docs: add runner documentation and move hooks documentation to devdocs * docs: add stubs for modules technical description * docs: add paragraph about event thread-safety * docs: add 'Current modules' section header 2019-12-12 12:25:19 +03:00
dev docs 2023-10-27 17:42:10 +02:00			`>Note: notifications or other application windows, that are shown above the window under test, can disrupt the testing process.`
Devdocs reorganisation (#913) * docs: split usage and dev docs * # This is a combination of 2 commits. # This is the 1st commit message: docs: split usage and dev docs # The commit message #2 will be skipped: # fixup add docs * docs: add runner documentation and move hooks documentation to devdocs * docs: add stubs for modules technical description * docs: add paragraph about event thread-safety * docs: add 'Current modules' section header 2019-12-12 12:25:19 +03:00

dev docs 2023-10-27 17:42:10 +02:00			`## Extra tools and information`
Devdocs reorganisation (#913) * docs: split usage and dev docs * # This is a combination of 2 commits. # This is the 1st commit message: docs: split usage and dev docs # The commit message #2 will be skipped: # fixup add docs * docs: add runner documentation and move hooks documentation to devdocs * docs: add stubs for modules technical description * docs: add paragraph about event thread-safety * docs: add 'Current modules' section header 2019-12-12 12:25:19 +03:00
dev docs 2023-10-27 17:42:10 +02:00			`Test samples: https://github.com/microsoft/WinAppDriver/tree/master/Samples`
Devdocs reorganisation (#913) * docs: split usage and dev docs * # This is a combination of 2 commits. # This is the 1st commit message: docs: split usage and dev docs # The commit message #2 will be skipped: # fixup add docs * docs: add runner documentation and move hooks documentation to devdocs * docs: add stubs for modules technical description * docs: add paragraph about event thread-safety * docs: add 'Current modules' section header 2019-12-12 12:25:19 +03:00
dev docs 2023-10-27 17:42:10 +02:00			`While working on tests, you may need a tool that helps you to view the element's accessibility data, e.g. for finding the button to click. For this purpose, you could use [AccessibilityInsights](https://accessibilityinsights.io/docs/windows/overview) or [WinAppDriver UI Recorder](https://github.com/microsoft/WinAppDriver/wiki/WinAppDriver-UI-Recorder).`
Devdocs reorganisation (#913) * docs: split usage and dev docs * # This is a combination of 2 commits. # This is the 1st commit message: docs: split usage and dev docs # The commit message #2 will be skipped: # fixup add docs * docs: add runner documentation and move hooks documentation to devdocs * docs: add stubs for modules technical description * docs: add paragraph about event thread-safety * docs: add 'Current modules' section header 2019-12-12 12:25:19 +03:00
dev docs 2023-10-27 17:42:10 +02:00			`>Note: close helper tools while running tests. Overlapping windows can affect test results.`