Qbs

Blog Documentation Get Qbs Community
  • Qbs Manual
  • QbsModules
  • innosetup
  • Qbs 2.4.0
  • innosetup

    Provides Inno Setup support. More...

    Since: Qbs 1.7

    Properties

    Detailed Description

    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 Product.targetName property to set the filename. Qbs also overrides any Output commands by passing the /O option to the ISCC compiler.

    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.

    Property Documentation

    compilerFlags : stringList

    A list of additional flags for the Inno Setup compiler.

    Default: Undefined


    compilerName : string

    The name of the compiler binary.

    This property should not normally need to be changed.

    Default: "ISCC.exe"


    compilerPath : string

    The full path of the compiler binary.

    This property should not normally need to be changed.

    Default: compilerName


    defines : stringList

    A 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"']

    Default: Undefined


    includePaths : pathList

    A list of include paths.

    Relative paths are considered to be relative to the .qbs product file they are used in.

    Default: Undefined


    toolchainInstallPath : path

    The Inno Setup installation directory.

    Determined by searching the registry for the latest version.

    This property should not normally need to be changed.

    Default: Determined automatically.


    verboseOutput : bool

    Whether to display verbose output from the Inno Setup compiler.

    Default: false


    version : string

    The Inno Setup version.

    Consists of three numbers separated by dots, for instance "5.5.9".

    Default: Undefined


    versionMajor : int

    The Inno Setup major version.

    Default: versionParts[0]


    versionMinor : int

    The Inno Setup minor version.

    Default: versionParts[1]


    versionParts : list

    The Inno Setup version as a list.

    For instance, Inno Setup version 5.5.9 would correspond to a value of [5, 5, 9].

    Default: []


    versionPatch : int

    The Inno Setup patch level.

    Default: versionParts[2]