qbs

目标平台的处理器体系结构。

undefined 表示目标平台是体系结构无关的（例如 CLR 或 JVM）。

该属性通常在配置文件中设置。

常用值包括："x86"、"x86_64" 和 "arm"。

支持的处理器体系结构

此表描述了体系结构属性的可能的值

默认值：未定义

产品将构建的架构。

默认值：未定义

此属性自Qbs 1.9引入。

当前构建的构建变体的名称。

可能的值是 "debug"，"release" 和 "profiling"。调试构建通常包含调试应用所需的额外调试符号，并且关闭了优化。分析构建通常包含调试符号，并且打开了优化。这对于分析工具或需要在发布构建中保留调试符号时很有用。发布构建是一个没有调试信息且启用优化的构建。

默认值：如果 qbs.configurationName 是 "release" 则为 "release"。否则 "debug"

将为该产品构建的构建变体。

默认值：未定义

此属性自Qbs 1.9引入。

当前构建配置的名称。

通过命令行参数 config 设置构建配置。有关更多信息，请参阅 build。

默认值："default"

此属性自Qbs 1.6引入。

是否生成调试信息。

默认值：如果 qbs.buildVariant 是 "debug" 或 "profiling" 则为 true。否则 false。

是否在产品中启用调试功能。不要与生成调试符号或代码优化级别混淆。

当启用时，此属性更改以下内容

• 向Windows链接器传递一个标志以链接到调试Windows CRT（公共运行时）库（例如 /MTd 而不是 /MT）

当禁用时，此属性更改以下内容

• 向编译器传递 NDEBUG 定义

通常，此属性在调试构建中启用，在发布或分析构建中禁用。

默认值：调试构建为 true，否则为 false。

是否要安装某些文件集。

通常，此属性在Group项目中设置，以标记多个文件为可安装。

默认值：false

为product或Group中的文件的安装目录。

此属性的值是相对于installPrefix的路径。

默认值：未定义

全局安装前缀。它在installDir的所有值之前自动添加。

此属性的值在安装上下文中相对于installRoot。

默认值：Unix上为"/usr/local"，否则为""

此属性是在Qbs 1.1中引入的。

全局安装根。它在installPrefix的安装上下文中自动添加。

默认值：<build dir>/install-root

此属性是在Qbs 1.4中引入的。

将要安装的本地文件的基目录。源基目录从installDir中指定的目标目录路径中省略。

默认值：要安装的当前文件的目录，相对于产品的源目录。

此属性是在Qbs 1.4中引入的。

所有工具链应执行的一般优化类型。

允许的值有

• "fast"
• "none"
• "small"

默认值：如果qbs.buildVariant为"debug"，则为"none"。否则为"fast"。

应为产品构建的配置文件。

对于此处列出的每个配置文件，都将根据各自配置文件中设置的属性构建产品的一个实例。

默认值：[project.profile]

此属性自Qbs 1.9引入。

与命令行解释器对应的平台特定文件路径。

在Windows上，这是cmd.exe的路径，该路径保存在COMSPEC环境变量中（通常是C:/Windows/System32/cmd.exe），在Unix-like平台上，这是/bin/sh。

默认值：Windows上的"%COMSPEC%"，Unix上的"/bin/sh"

此属性是在Qbs 1.5中引入的。

目标平台的sysroot。

通常在配置文件中设置此属性以进行交叉编译。

默认值：未定义

包含描述用于构建项目的操作系统和操作系统家族的字符串值列表。

此属性基于targetPlatform属性计算得出，通常用于条件语句中测试特定的操作系统或操作系统家族。

Group {
    // Includes all Unix-like platforms, such as: Linux, BSD, Apple platforms and others.
    condition: qbs.targetOS.includes("unix")
    files: ...
}
Group {
    // Includes all Apple platforms, such as macOS, iOS, and iOS Simulator.
    condition: qbs.targetOS.includes("darwin")
    files: ...
}
Group {
    // Includes only macOS
    condition: qbs.targetOS.includes("macos")
    files: ...
}

避免为此目的使用targetPlatform。例如，而不是

qbs.targetPlatform === "macos" || qbs.targetPlatform === "ios" || qbs.targetPlatform === "tvos" || qbs.targetPlatform === "watchos"

使用

qbs.targetOS.includes("darwin")

然而，在某些情况下，使用targetPlatform是可以接受的，例如，当结果条件更简单但仍正确时

qbs.targetPlatform === "linux"

versus

qbs.targetOS.includes("linux") && !qbs.targetOS.includes("android")

有关可能的完整值列表，请参阅targetPlatform和targetOS之间的关系。

默认值：未定义

您想要为构建的操作系统。

此属性通常会设置在配置文件中或为特定产品，其中的目标操作系统始终是已知的（例如，用原生代码编写的Apple Watch应用）。

例如，用于构建iOS仿真平台配置文件的属性设置为ios-simulator值。

profiles.xcode-iphonesimulator.qbs.targetPlatform: "ios-simulator"

通常应将此属性视为只写，避免使用它来测试当前目标操作系统。相反，应使用targetOS属性来进行条件测试。

targetPlatform和targetOS之间的关系

此表描述了可能的值以及targetPlatform和targetOS属性之间的匹配关系。

默认值：Host.platform()

此属性是在Qt 1.11中引入的。

另请参阅：目标平台。

包含描述用于构建项目的工具链和工具链家族的字符串值列表。

此属性从toolchainType属性推导而来，并通常用于条件语句中测试特定的工具链或工具链家族。

Properties {
    // flags for GCC
    condition: qbs.toolchain.includes("gcc")
    cpp.commonCompilerFlags: ...
}
Properties {
    // flags for MSVC
    condition: qbs.toolchain.includes("msvc")
    cpp.commonCompilerFlags: ...
}

与toolchainType不同，它包含单个值，qbs.toolchain是一个包含工具链家族的字符串列表。这使得条件和检查更加简单。例如，而不是

(qbs.toolchainType === "xcode" || qbs.toolchainType === "clang" || qbs.toolchainType === "gcc")

使用

qbs.toolchain.includes("gcc")

由于XCode、GCC和Clang属于"gcc"家族。

toolchainType和toolchain之间的关联

此表描述了toolchainType属性和toolchain属性之间的可能值和匹配关系

默认值：未定义

此构建将要使用的工具链。

例如，要使用"clang"工具链构建项目，只需这样做

qbs build qbs.toolchainType:clang

通常应将此属性视为写入-only，并避免使用它来测试当前工具链。相反，请使用toolchain属性进行条件测试。

典型值包括："gcc"、"clang"、"clang-cl"、"mingw"、"msvc"和"xcode"。另请参阅Relation between toolchainType and toolchain。

默认情况下，qbs.toolchainType将根据targetOS属性自动检测

默认值：自动检测

此属性是在Qbs 1.11中引入的。

作为字符串的Qbs版本号。例如："1.4.1"。

此属性是在Qbs 1.4.1中引入的。

Qbs的主版本号。

此属性是在Qbs 1.4.1中引入的。

Qbs的次要版本号。

此属性是在Qbs 1.4.1中引入的。

Qbs的修补程序版本号。

此属性是在Qbs 1.4.1中引入的。