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:

 

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:

 

 

Specify the argument on the command line in the following way:

Light.exe <some_wixobj_file> -dWixUILicenseRtf=[Path-to-License-file]

Share this