Index: tools/accessibility/nvda/README.txt |
diff --git a/tools/accessibility/nvda/README.txt b/tools/accessibility/nvda/README.txt |
new file mode 100644 |
index 0000000000000000000000000000000000000000..ce34d93bd23bb7d9aa18f22c71df9465b7057285 |
--- /dev/null |
+++ b/tools/accessibility/nvda/README.txt |
@@ -0,0 +1,58 @@ |
+This directory contains semi-automated tests of Chrome with |
+NVDA (NonVisual Desktop Access), a popular open-source screen reader for |
+visually impaired users on Windows. It works by launching Chrome in a |
+subprocess, then launching NVDA in a special environment that simulates |
+speech rather than actually speaking, and ignores all events coming from |
+processes other than a specific Chrome process ID. Each test automates |
+Chrome with a series of actions and asserts that NVDA gives the expected |
+feedback in response. |
+ |
+Instructions for running these tests: |
+ |
+1. Install Python 2.7, 32-bit: http://www.python.org/ |
+ |
+ Note - the version of Python installed by Chrome's depot_tools will not |
+ work, it's 64-bit. |
+ |
+2. Download pywinauto here: |
+ https://code.google.com/p/pywinauto/downloads/list |
+ |
+ Unzip it, then install it by running this from a cmd shell in that directory: |
+ python setup.py install |
+ |
+ If you get an error, make sure you're using the 32-bit version of Python. |
+ |
+3. Install the latest NVDA "next" snapshot from: |
+ http://community.nvda-project.org/wiki/Snapshots |
+ |
+ In the installer, choose "Create Portable copy" rather than "Install...". |
+ From the Browse dialog, create an new folder called nvdaPortable inside |
+ this folder. |
+ |
+ Note: after NVDA 2014.3 stable is released, just use the stable version |
+ instead, from http://www.nvaccess.org/download/ |
+ - if you do this, you need to run NVDA, then from the NVDA menu, choose |
+ Tools > Create Portable Copy. |
+ From the Browse dialog, create an new folder called nvdaPortable inside |
+ this folder. |
+ You should now have something like this: |
+ d:\src\nvda_chrome_tests\nvdaPortable\nvda.exe |
+ You can now exit NVDA. |
+ |
+4. Install Chrome Canary. The binary is typically installed in: |
+ c:\Users\USERNAME\AppData\Local\Google\Chrome SxS\Application\chrome.exe |
+ ...if not, edit nvda_chrome_tests.py to point to it. |
+ |
+5. Clone the nvda-proctest environment into this directory: |
+ git clone https://bitbucket.org/nvaccess/nvda-proctest.git |
+ |
+6. Run the tests: |
+ |
+ First make sure NVDA is not already running. |
+ |
+ Open a cmd console, change to the nvda_chrome_tests directory, and run: |
+ python nvda_chrome_tests.py |
+ |
+ If you get an error, open the Windows task manager and make sure NVDA |
+ isn't running, kill it if necessary. |
+ |