WiX based Windows installer for GPII
- A local copy of the GPII/windows repository. You should be able to build the repository, so all requirements of building GPII/windows apply here as well.
- WiX Toolset v3.10
- MSBuild Extension Pack v4
Make sure MSBuild and the WiX folder are in the path.
- Build GPII/windows
- Edit line 10 of
setup/build.cmd
and replaceC:\projects\gpii\windows
with the path of your local GPII/windows repository (no trailing backslash) - Run
setup/build.cmd
Staging makes a private copy of the GPII/windows repository inside the staging
folder and uses that for building the installer. Any files not needed (eg Git and Vagrant related folders) are excluded.
After running build.cmd
, an MSI file can be found in the output
folder.
Whenever there are changes to the local GPII/windows repository, rerun build.cmd
to make a new installer.
The installer is a standard MSI file and as such it can be also executed using msiexec.exe
and supports all the command-line options available to msiexec.exe
.
To perform an unattended installation (requires administrative rights):
msiexec /qn /i GPII.msi
To perform an unattended installation and keep a verbose log to log.txt
:
msiexec /qn /lv log.txt /i GPII.msi
To silently uninstall:
msiexec /qn /x GPII.msi
You can pass a number of property key/values to the installer to customize its behavior.
For example, to perform an unattended installation to C:\GPII
:
msiexec /qn /i GPII.msi INSTALLFOLDER=C:\GPII
To perform an unattended installation to C:\GPII
that creates no desktop shortcuts:
msiexec /qn /i GPII.msi INSTALLFOLDER=C:\GPII ADDLOCAL=GPIIFeature,VCRedist DESKTOP_SHORTCUTS=0
The list of possible properties include:
Name | Value | Description |
---|---|---|
INSTALLFOLDER | A folder name Default: C:\Program Files\GPII or C:\Program Files (x86)\GPII |
The installation folder |
ADDLOCAL | Comma (,) separated list </br/>Possible values:
|
The GPII features that will get installed. It is advisable to always include GPIIFeature (the main GPII platform) and VCRedist (the Visual C++ Redistributable Package). |
SHORTCUTS | 0 or 1 (Default) |
Whether or not to create any desktop and start menu shortcuts |
DESKTOP_SHORTCUTS | 0 or 1 (Default) |
Whether or not to create any desktop shortcuts |
START_MENU_SHORTCUTS | 0 or 1 (Default) |
Whether or not to create any start menu shortcuts |
GPII_SHORTCUTS GPII_DESKTOP_SHORTCUTS GPII_START_MENU_SHORTCUTS |
0 or 1 (Default) |
Whether or not to create shortcuts for the main GPII platform |
GPII_AUTOSTART | 0 (Default) or 1 |
Whether or not to autostart GPII on Windows sign in |
An exhaustive list of other properties can be found at the Windows Installer Guide.