状态

概述

qbs status [options] [config:configuration-name]

描述

列出项目目录中的所有文件，并显示它们在相应配置中是否为 Qbs 所知。

选项

--build-directory|-d <directory>

指定存储构建工件的位置 <directory>。

默认值为当前目录，除非设置了 preferences.defaultBuildDirectory。

相对路径将被解释为相对于当前目录。

您可以使用以下特殊值作为占位符

• @project 展开为不带扩展名 .qbs 的项目文件名称。
• @path 展开为包含项目文件的目录名称。

--settings-dir <directory>

从指定的 <directory> 读取所有设置（例如 配置文件 信息）。如果该目录不存在，则将其创建。

默认值为系统特定。例如

• Linux: $HOME/.config/QtProject/qbs
• Windows: %APPDATA%\QtProject\qbs
• macOS: $HOME/Library/Preferences/qbs

参数

config:configuration-name

指定要使用的构建配置。

Qbs 可以一次性为单个或多个配置构建项目，每个配置都有不同的参数集。config 参数具有特殊功能：在新出现的每次 config 下，一个新的配置实例开始，并且直到下一次 config 出现的所有后续参数都分配到该实例。在第一个 config 出现之前的参数分配应用于所有构建配置。在产品和模块内部，当前活动构建配置可以通过 qbs.configurationName 获取。

在以下代码片段中，将配置文件 clang 应用到所有配置，而 cpp.optimization 对于 debug 和 release 不同

profile:clang config:debug cpp.optimization:none config:release cpp.optimization:small

config 的值决定了构建文件夹的名称并影响 qbs.buildVariant 属性的默认值。Qbs 知道 config 值 "debug" 和 "release"，但通常可以任选名称。为特殊目的创建的配置命名时，请遵循在编程语言中通常使用的合法名称规则

• 第一个字符必须是字母（a-z）、下划线 (_) 或美元符号 ($)。
• 后续字符可以是字母、数字、下划线或美元符号。

示例

要列出项目目录中的文件并查看其状态

qbs status