WiX Toolset Descriptors Generator

WiX is a toolset for creating Windows MSI installers.

This project provides Java API (on top of JAXB) that allows to generate WiX descriptors for installers from file system directories.

Generated installers have simple UI and supports the following features:

• choose install path
• set environment variables
• set Windows registry keys
• custom icon and logos

wixgen.jar utility allows to use that API from a command line.

Javadocs links:

• JAXB classes
• DirectoryGenerator API

Usage

To generate installer from the input directory prepare the following resources (examples):

• greetings banner (BMP, 493x312)
• top banner (BMP, 493x58)
• application icon (ICO)
• license file (RTF)
• wixgen config file (JSON)

Generate WiX .wxs descriptor:

java -jar wixgen.jar path/to/input/dir -c config.json -o myapp.wxs

Compile .wxs descriptor into .wixobj object file:

candle myapp.wxs:

Build the installer from .wixobj object file:

light -ext WixUIExtension myapp.wixobj

Building with non-english locale

When building wixgen with non-english system locale it may be required to specify en locale through environment variable:

MAVEN_OPTS=-Duser.langage=en

See issue #2 for details.

License information

This project is released under the Apache License 2.0

Changelog

2019-02-05

• version 1.7
• support perUser/perMachine flag for package

2018-10-23

• version 1.6
• more config options
• allow to generate feature and directory parts of the descriptor

2018-04-18

• version 1.5.1
• jdk10 support

2018-01-24

• version 1.4
• 32-bit installers support

2017-05-14

• version 1.3
• support for (Default) registry keys

2016-05-13

• initial public version