gpii-windows v0.3.0-dev.20200427T102955Z.2e04c69

GPII for Windows

Contains platform-specific components of the GPII architecture for Windows. See http://gpii.net/ for overall details of the GPII project. After checkout out using git, this project will require node.js and npm to be installed - please consult http://wiki.gpii.net/w/Setting_Up_Your_Development_Environment for installation instructions.

Note that tests and function involving the High Contrast setting will fail on all current versions of Windows (including Windows 7 SP1 and Windows 8 SP2) unless the following hotfix from Microsoft is applied: http://support.microsoft.com/kb/2516889

See http://issues.gpii.net/browse/GPII-49 for more details of this issue.

Building

This package depends on node 6.x (LTS).

To build the GPII for Windows, perform the following:

git clone https://github.com/GPII/windows.git
cd windows
npm install

Test VM

It is possible to provision a Windows VM for testing purposes. Please ensure you have met these VM requirements before proceeding. After that you can use the vagrant up command to create an instance of a Windows 10 Evaluation VM which will boot an instance of the Windows 10 VM, pull in the GPII Framework's npm dependencies, and then build it.

If this is your first time creating this VM an 8 GB download will take place. The downloaded image will be valid for 90 days after which the Windows installation will no longer be useable. To remove an expired image you can use the vagrant box remove "inclusivedesign/windows10-eval" command.

Now you can open a command prompt window and use the following commands to test the framework:

refreshenv
cd c:\vagrant
node tests\UnitTests.js
node tests\AcceptanceTests.js builtIn

Note: The refreshenv command only needs to be used if you are about to issue commands after having just created the VM. If the VM has been restarted since its creation then the command is not required.