Qbs Manual | List of Modules | Module innosetup

Qbs 1.8.1

# Module innosetup

The `innosetup` module contains properties and rules for building EXE setup packages with Inno Setup. Inno Setup 5 and above are supported.

Note: A typical Inno Setup Script includes an OutputBaseFilename command to set the filename of the generated installer executable. However, Qbs overrides any OutputBaseFilename commands found in the script by passing the /F option to the ISCC compiler, and therefore, you must use the targetName property to set the filename. Qbs also overrides any Output commands by passing the /O option to the ISCC compiler.

## General Properties

Property | Type | Since | Default | Description
--- | --- | --- | --- | ---
defines | `stringList` | 1.7 | `undefined` | List of preprocessor macros that get passed to the compiler. To set macro values use the following syntax: `innosetup.defines: ["USE_COLORS=1", 'COLOR_STR="blanched almond"']`
includePaths | `pathList` | 1.7 | `undefined` | List of include paths. Relative paths are considered to be relative to the .qbs product file they are used in.
verboseOutput | `bool` | 1.7 | `false` | Whether to display verbose output from the Inno Setup compiler.
compilerFlags | `stringList` | 1.7 | `undefined` | Additional flags for the Inno Setup compiler.
version | `string` | 1.7 | `undefined` | The Inno Setup version. Consists of three numbers separated by dots, for instance "5.5.9".
versionMajor | `int` | 1.7 | `versionParts[0]` | The Inno Setup major version.
versionMinor | `int` | 1.7 | `versionParts[1]` | The Inno Setup minor version.
versionParts | `list` | 1.7 | `empty` | The Inno Setup version as a list. For instance, Inno Setup version 5.5.9 would correspond to a value of `[5, 5, 9]`.
versionPatch | `int` | 1.7 | `versionParts[2]` | The Inno Setup patch level.
toolchainInstallPath | `path` | 1.7 | determined automatically | Inno Setup installation directory. Determined by searching the registry for the latest version. This should not normally need to be changed.
compilerName | `string` | 1.7 | `"ISCC.exe"` | Name of the compiler binary. This should not normally need to be changed.
compilerPath | `string` | 1.7 | `compilerName` | Full path of the compiler binary. This should not normally need to be changed.

## Relevant File Tags

Tag | Auto-tagged File Names | Since | Description
--- | --- | --- | ---
`"innosetup.iss"` | `"*.iss"` | 1.7 | Source files with this tag identify Inno Setup Script files, which serve as inputs to a rule invoking the Inno Setup Script Compiler.
`"innosetup.exe"` | n/a | 1.7 | The rule that creates Inno Setup executable files attaches this tag (as well as the "application" tag) to its output artifact.