nsis QML Type
Provides Nullsoft Scriptable Install System support. More...
Import Statement: | import QbsModules |
Since: | Qbs 1.2 |
Properties
- compilerFlags : stringList
- compilerName : string
- compilerPath : string
- compressor : string
- defines : stringList
- disableConfig : bool
- enableQbsDefines : bool
- toolchainInstallPath : path
- version : string
- versionBuild : int
- versionMajor : int
- versionMinor : int
- versionParts : list
- versionPatch : int
- warningLevel : string
Detailed Description
The nsis
module contains properties and rules for building EXE installers for Windows using the Nullsoft Scriptable Install System (NSIS).
This module is available on all platforms.
Note: A typical NSIS script includes an OutFile
command to set the filename of the generated installer executable. However, Qbs overrides any OutFile
commands found in the script, and therefore, you must use the product.targetName property to set the filename.
Relevant File Tags
Tag | Auto-tagged File Names | Since | Description |
---|---|---|---|
"nsh" | *.nsh | 1.2 | This tag is attached to NSIS header files. |
"nsi" | *.nsi | 1.2 | This tag is attached to NSIS script files. |
"nsissetup" | - | 1.2 | The rule that creates the NSIS setup executable attaches this tag to its output artifact. |
Property Documentation
compilerFlags: stringList
A list of additional flags for the NSIS compiler.
Default: Undefined
compilerName: string
The name of the compiler binary.
This property should not normally need to be changed.
Default: "makensis"
compilerPath: string
The directory where the compiler binary is located.
This property should not normally need to be changed.
Default: compilerName
compressor: string
The compression algorithm used to compress files and data in the installer.
Setting this property overrides any SetCompressor
command in the NSI file being compiled.
Possible values include: "default"
, "zlib"
, "zlib-solid"
, "bzip2"
, "bzip2-solid"
, "lzma"
, "lzma-solid"
.
Default: "default"
defines: stringList
A list of preprocessor macros that get passed to the compiler.
To set macro values, use the following syntax:
cpp.defines: ["USE_COLORS=1", 'COLOR_STR="blanched almond"']
Default: Undefined
disableConfig: bool
Whether to exclude nsisconf.nsh
.
Generally, you do not need to set this property.
Default: false
enableQbsDefines: bool
toolchainInstallPath: path
The NSIS installation directory.
Determined by searching from the known registry keys and known installation paths until a match is found.
This property should not normally need to be changed.
Default: Determined automatically.
version: string
The NSIS version. Consists of four numbers separated by dots. For example, "2.46.0.0"
.
Default: Undefined
versionBuild: int
The fourth NSIS version number component.
Default: versionParts[3]
versionMajor: int
The NSIS major version.
Default: versionParts[0]
versionMinor: int
The NSIS minor version.
Default: versionParts[1]
versionParts: list
The NSIS version as a list.
For example, the NSIS version 2.46.0.0 would correspond to a value of [2, 46, 0, 0]
.
Default: []
versionPatch: int
The NSIS patch level.
Default: versionParts[2]
warningLevel: string
The severity of the warnings to emit. The higher the level, the more warnings will be shown.
The levels none
, errors
, warnings
, info
, and all
correspond to the NSIS verbosity levels 0 through 4, inclusive. normal
corresponds to the default level.
Default: "normal"