|
1 |
| -WinAppDriver - WebDriver for Windows Applications |
2 |
| -================================================= |
| 1 | +# WinAppDriver - WebDriver for Windows Applications |
3 | 2 |
|
4 |
| -WinAppDriver is a [WebDriver implementation](//github.com/imsardine/winappdriver/wiki/Protocol-Implementation) for Windows applications, including [desktop applications](//github.com/imsardine/winappdriver/wiki/Desotop-Applications) and [universal apps](//github.com/imsardine/winappdriver/wiki/Universal-Apps) (formerly known as store apps, modern UI apps, or Metro-style apps). Support of [CEF-based desktop applications](//github.com/imsardine/winappdriver/wiki/Hybrid-Desktop-Applications) and [Windows Phone apps](//github.com/imsardine/winappdriver/wiki/Windows-Phone-Apps) is also planned. |
| 3 | +WinAppDriver is a GUI test automation library for use with Windows applications, and technically it is a [WebDriver implementation](https://github.com/imsardine/winappdriver/wiki/Protocol-Implementation) for Windows applications. |
5 | 4 |
|
6 |
| -Give it a try, and your feeback is appreciated. |
| 5 | +In the beginning, it supports only [store apps](https://github.com/imsardine/winappdriver/wiki/Store-Apps), and then the support for [traditional desktop application](https://github.com/imsardine/winappdriver/wiki/Desktop-Applications) is added. As the name suggests, it aims for being a single tool for test automation of all kinds of Windows applications, therefore the support for [CEF-based desktop applications](https://github.com/imsardine/winappdriver/wiki/CEF-Based-Applications) and [Windows Phone apps](https://github.com/imsardine/winappdriver/wiki/Phone-Apps) are planned as well. |
7 | 6 |
|
8 |
| -##Getting Started |
| 7 | +**Give it a try! To get started, follow the instructions described in [Getting Started](https://github.com/imsardine/winappdriver/wiki/Getting-Started), and your [feedback](https://github.com/imsardine/winappdriver/issues) is highly appreciated.** |
9 | 8 |
|
10 |
| -###Install WinAppDriver: |
| 9 | +Hope that this tool will make our life more easier if you are asked to implement automated test against Windows applications. |
11 | 10 |
|
12 |
| - 1. [Download](https://github.com/imsardine/winappdriver/releases/download/v0.1/WinAppDriverInstaller.msi) the installer and execute it. A desktop shortcut will be created for launching _WinAppDriver Server_. |
| 11 | +## Documentation |
13 | 12 |
|
14 |
| - 2. Launch the server, and it listens on port 4444 on all addresses. |
| 13 | +In addition to [wiki](https://github.com/imsardine/winappdriver/wiki), Here are some documents/slides: |
15 | 14 |
|
16 |
| -Then you can control the application under test (or even whole desktop) with any [WebDriver language bindings](http://docs.seleniumhq.org/download/#client-drivers) you prefer. Several [desired capabilities](//github.com/imsardine/winappdriver/wiki/Desired-Capabilities) could be used to how the server behaves for a specific session. |
17 |
| - |
18 |
| -###Quick Start |
19 |
| - |
20 |
| -Take whole desktop as an example: |
21 |
| - |
22 |
| -(Python) |
23 |
| -```python |
24 |
| -from selenium.webdriver import Remote, DesiredCapabilities |
25 |
| - |
26 |
| -desired_caps = {} |
27 |
| -driver = Remote('http://your-winappdriver-server:4444/wd/hub', desired_caps) |
28 |
| - |
29 |
| -driver.find_element_by_id('username').send_keys('your-username') |
30 |
| -driver.find_element_by_id('password').send_keys('your-password') |
31 |
| -driver.find_element_by_id('signin').click() |
32 |
| -``` |
33 |
| - |
34 |
| -TBD: C#, Java, Ruby |
35 |
| - |
36 |
| -Here are other scenarios supported by WinAppDriver: |
37 |
| - |
38 |
| - * [Whole Desktop](//github.com/imsardine/winappdriver/wiki/Whole-Desktop) (for more details) |
39 |
| - * [Desktop Applications](//github.com/imsardine/winappdriver/wiki/Desotop-Applications) ([already installed?](//github.com/imsardine/winappdriver/wiki/Desotop-Applications-Already-Installed)) |
40 |
| - * [Universal Apps](//github.com/imsardine/winappdriver/wiki/Universal-Apps) ([already installed?](//github.com/imsardine/winappdriver/wiki/Universal-Apps-Already-Installed)) |
41 |
| - |
42 |
| -##Documentation |
43 |
| - |
44 |
| -In addition to [wiki](//github.com/imsardine/winappdriver/wiki), Here are some documents/slides: |
45 |
| - |
46 |
| - * [Windows Store Apps Test Automation](http://www.slideshare.net/jeremykao92/winappdriver-windows-store-apps-test-automation) |
47 |
| - * [WinAppDriver Developemnt](http://www.slideshare.net/jeremykao92/winappdriver-development) |
| 15 | + * [WinAppDriver - Drive Windows Applications Using Selenium (GTAC 2015 Submission)](https://www.youtube.com/watch?v=OyjaU2d63Kw) (Aug 10, 2015) |
| 16 | + * [WinAppDriver Development](http://www.slideshare.net/jeremykao92/winappdriver-development) (Dec 17, 2014) |
| 17 | + * [Windows Store Apps Test Automation](http://www.slideshare.net/jeremykao92/winappdriver-windows-store-apps-test-automation) (Dec 11, 2014) |
48 | 18 |
|
49 | 19 | ##License
|
50 | 20 |
|
51 | 21 | WinAppDriver is licensed under MIT. Refer to [LICENSE](LICENSE) for more information.
|
| 22 | + |
0 commit comments