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

PropertyTypeSinceDefaultDescription
definesstringList1.7undefinedList 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"']
includePathspathList1.7undefinedList of include paths. Relative paths are considered to be relative to the .qbs product file they are used in.
verboseOutputbool1.7falseWhether to display verbose output from the Inno Setup compiler.
compilerFlagsstringList1.7undefinedAdditional flags for the Inno Setup compiler.
versionstring1.7undefinedThe Inno Setup version. Consists of three numbers separated by dots, for instance "5.5.9".
versionMajorint1.7versionParts[0]The Inno Setup major version.
versionMinorint1.7versionParts[1]The Inno Setup minor version.
versionPartslist1.7emptyThe Inno Setup version as a list. For instance, Inno Setup version 5.5.9 would correspond to a value of [5, 5, 9].
versionPatchint1.7versionParts[2]The Inno Setup patch level.
toolchainInstallPathpath1.7determined automaticallyInno Setup installation directory. Determined by searching the registry for the latest version. This should not normally need to be changed.
compilerNamestring1.7"ISCC.exe"Name of the compiler binary. This should not normally need to be changed.
compilerPathstring1.7compilerNameFull path of the compiler binary. This should not normally need to be changed.

Relevant File Tags

TagAuto-tagged File NamesSinceDescription
"innosetup.iss""*.iss"1.7Source 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/a1.7The rule that creates Inno Setup executable files attaches this tag (as well as the "application" tag) to its output artifact.