gpii-app is an Electron-based application wrapper for the GPII autopersonalization system.
It currently only supports Windows.
It is possible to provision a Windows VM for development and 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. Once it has finished building, either restart the VM,
or open a Command Line or PowerShell and type the following command inside the VM: refreshenv
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 run the GPII app:
cd c:\vagrant\
npm start
Alternatively, running the application in development mode will give you a list of snapsets in the task tray menu:
npm run dev
Ensure that your virtual box is up and running, then open a terminal (in the VM), go to the folder with gpii-app and run the test script:
cd v:\
npm test
This will also instrument the code and generate a coverage report in the reports
subdirectory. If you want to run
the tests without collecting code coverage data, you can use commands like the following instead:
cd v:\
npm run test:noCoverage
Some operations may require the Morphic Windows Service to be running. The service can be started with the following:
cd c:\vagrant\
npm run service
This will start the service in such a way that will allow instances of the GPII app to connect to it, in an untrusted manner.