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. |