OLD | NEW |
(Empty) | |
| 1 This directory contains semi-automated tests of Chrome with |
| 2 NVDA (NonVisual Desktop Access), a popular open-source screen reader for |
| 3 visually impaired users on Windows. It works by launching Chrome in a |
| 4 subprocess, then launching NVDA in a special environment that simulates |
| 5 speech rather than actually speaking, and ignores all events coming from |
| 6 processes other than a specific Chrome process ID. Each test automates |
| 7 Chrome with a series of actions and asserts that NVDA gives the expected |
| 8 feedback in response. |
| 9 |
| 10 Instructions for running these tests: |
| 11 |
| 12 1. Install Python 2.7, 32-bit: http://www.python.org/ |
| 13 |
| 14 Note - the version of Python installed by Chrome's depot_tools will not |
| 15 work, it's 64-bit. |
| 16 |
| 17 2. Download pywinauto here: |
| 18 https://code.google.com/p/pywinauto/downloads/list |
| 19 |
| 20 Unzip it, then install it by running this from a cmd shell in that directory: |
| 21 python setup.py install |
| 22 |
| 23 If you get an error, make sure you're using the 32-bit version of Python. |
| 24 |
| 25 3. Install the latest NVDA "next" snapshot from: |
| 26 http://community.nvda-project.org/wiki/Snapshots |
| 27 |
| 28 In the installer, choose "Create Portable copy" rather than "Install...". |
| 29 From the Browse dialog, create an new folder called nvdaPortable inside |
| 30 this folder. |
| 31 |
| 32 Note: after NVDA 2014.3 stable is released, just use the stable version |
| 33 instead, from http://www.nvaccess.org/download/ |
| 34 - if you do this, you need to run NVDA, then from the NVDA menu, choose |
| 35 Tools > Create Portable Copy. |
| 36 From the Browse dialog, create an new folder called nvdaPortable inside |
| 37 this folder. |
| 38 You should now have something like this: |
| 39 d:\src\nvda_chrome_tests\nvdaPortable\nvda.exe |
| 40 You can now exit NVDA. |
| 41 |
| 42 4. Install Chrome Canary. The binary is typically installed in: |
| 43 c:\Users\USERNAME\AppData\Local\Google\Chrome SxS\Application\chrome.exe |
| 44 ...if not, edit nvda_chrome_tests.py to point to it. |
| 45 |
| 46 5. Clone the nvda-proctest environment into this directory: |
| 47 git clone https://bitbucket.org/nvaccess/nvda-proctest.git |
| 48 |
| 49 6. Run the tests: |
| 50 |
| 51 First make sure NVDA is not already running. |
| 52 |
| 53 Open a cmd console, change to the nvda_chrome_tests directory, and run: |
| 54 python nvda_chrome_tests.py |
| 55 |
| 56 If you get an error, open the Windows task manager and make sure NVDA |
| 57 isn't running, kill it if necessary. |
| 58 |
OLD | NEW |