WiX Toolset examples ⬆
|
Directory examples\ contains WiX examples coming from various websites.
|
The WiX Toolset examples presented in the following sections
- share the same project organisation as the WiX examples from page
myexamples/README.md. - differ in several respects from the WiX examples from page
myexamples/README.md, in particular :- we slightly modified the main WiX source file to match our project settings.
- we recreated most resource files (e.g. images) not made available by the original author.
MinAppKiller is adapted from Heiswayi Nrird's blog post What is WiX Toolset & how to use it (May 2018).
The project directory is organized as follows :
> cd Y:\examples\MiniAppKiller > tree /f . | findstr /v /b [a-z] │ 00download.txt │ build.bat ├───app │ config.ini │ EULA-en.rtf │ EULA-fr.rtf │ filters.txt │ MiniAppKiller.exe 1 └───src │ Product.Var.wxi │ Product.wxs ├───images │ app.ico │ app.ico.txt │ Dialog.bmp │ Dialog.bmp.txt │ TopBanner.bmp │ TopBanner.bmp.txt └───localizations Product.Loc_en-US.wxl Product.Loc_fr-FR.wxl
Figures 1.1 to 1.4 below illustrate the localized graphical user interface of the generated MiniAppKiller Windows installer while figures 1.5 and 1.6 show the updated user environment.
Figure 1.1 - Welcome
(MiniAppKiller installer). 
Figure 1.2 - EULA
(MiniAppKiller installer). |
Figure 1.3 - Destination Folder
(MiniAppKiller installer). 
Figure 1.4 - Completed installation
(MiniAppKiller installer). |
Figure 1.5 - MiniAppKiller application
(Program Files folder). 
Figure 1.6 - Uninstall MiniAppKiller
(Settings folder). |
uberAgent is adapted from Helge Klein's blog post Real-World Example: WiX/MSI Application Installer (February 2021).
The project directory is organized in the same way as the previous WiX example :
> cd Y:\examples\uberAgent > tree /f . | findstr /v /b [a-z] │ 00download.txt │ build.bat ├───app │ Eula-en.rtf │ uberAgent.conf │ uberAgent.conf.txt │ uberAgent.exe 1 └───src │ LicenseAgreementDlg_HK.wxs │ Product.wxs │ Product_en-us.wxl │ ServerDlg.wxs │ WixUI_HK.wxs └───images app.ico app.png app.png.txt BannerTop.bmp Dialog.bmp Dialog.bmp.txt
Figures 2.1 to 2.4 below illustrate the localized graphical user interface of the generated uberAgent Windows installer.
Figure 2.1 - Welcome
(uberAgent installer). 
Figure 2.2 - EULA
(uberAgent installer). |
Figure 2.3 - Destination Folder
(uberAgent installer). 
Figure 2.4 - Receiver Configuration
(uberAgent installer). |
WiXCustomDialog Example ▴
WiXCustomDialog is adapted from glytzhkof's GitHub repository glytzhkof/WiXCustomDialog (February 2021).
The project directory is organized in the same way as the previous WiX example :
> cd Y:\examples\WiXCustomDialog > tree /f . | findstr /v /b [a-z] │ 00download.txt │ build.bat └───src │ Product.wxs │ WixUI_Mondo.wxs │ WixUI_MyMondo.wxs └───resources Banner.bmp Image.bmp
Command build -verbose link generates file WiXCustomDialog-1.0.0.msi:
> build -verbose clean link Compiling 3 WiX source files to directory "target" Create Windows installer "target\WiXCustomDialog-1.0.0.msi" Sign file "target\WiXCustomDialog-1.0.0.msi" Done Adding Additional Store Successfully signed: Y:\examples\WiXCustomDialog\target\WiXCustomDialog-1.0.0.msi
Figure 3.1 - Welcome
(WiXCustomDialog installer). 
Figure 3.2 - EULA
(WiXCustomDialog installer). |
Figure 3.3 - Dialog Title
(WiXCustomDialog installer). 
Figure 3.4 - Choose Setup Type
(WiXCustomDialog installer). |
[1] Missing application files ↩
-
Since the original application (resp. its source files) is not available we must be satisfied with a "body double" instead of the orginal one; concretely we simply copy (and rename) the Windows Calculator (aka.
%WINDIR%\system32\calc.exe) during the build process.