Using WiX UI library
When using WiX, I found that most of the development time is spend on building a user interface. Fortunately WiX provides a library with some default dialog sets. Those dialog sets provide a familiar wizard-style user interface and can help you build MSI files much faster. At the WiX website you can read which dialog sets are available in the WiX library.
In most cases these dialog sets will provide the user experience you need, although you might want to change the background image, banner image or change the license text to give the MSI a custom look and feel.
With WiX 2 this can be accomplished by placing the appropriate image files in a sub-folder of the current directory in which the wixobj file is located. The sub-folder should be named: Bitmaps. In this directory files can be placed that must be used by light.exe instead of the defaults. These files must have specific names and dimension. In the table below the different filenames, and dimensions are mentioned:
File name |
Description |
Dimensions |
bannrbmp.bmp |
Top banner bitmap |
500 × 63 |
dlgbmp.bmp |
Background bitmap used on welcome and install-complete dialogs |
503 × 314 |
exclamic.ico |
Exclamation icon on the wait-for-costing dialog |
32 × 32 |
info.ico |
Information icon on the cancel and error dialogs |
32 × 32 |
New.ico |
Button icon on directory-browse dialog |
16 × 16 |
Up.ico |
Button icon on directory-browse dialog |
16 × 16 |
The license text can be updated by placing a License.rtf file in the in the directory were the wixobj file is located.
Unfortunately this trick doesn’t work anymore with WiX 3. This doesn’t mean that it is not possible to change the images or license text. With WiX 3 you can specify the images, icons and license text by providing the path to those files as arguments on the command line. The following arguments are available for this:
Property name |
Description |
WixUIBannerBmp |
Path to the top banner bitmap |
WixUIDialogBmp |
Path to the background bitmap used on welcome and install-complete dialogs |
WixUIExclamationIco |
Path to the exclamation icon on the wait-for-costing dialog |
WixUIInfoIco |
Path to the information icon on the cancel and error dialogs |
WixUINewIco |
Path to the button icon on directory-browse dialog |
WixUIUpIco |
Path to the button icon on directory-browse dialog |
WixUILicenseRtf |
Path to the license file |
Specify the argument on the command line in the following way:
Light.exe <some_wixobj_file> -dWixUILicenseRtf=[Path-to-License-file]