清理

概述

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

描述

删除指定构建配置的构建工件。

选项

`--build-directory|-d <directory>`

指定用于存储构建工件的一个 <directory>。

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

相对路径将以当前目录为基准进行解析。

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

@project 将展开为项目文件名（不包括 .qbs 扩展名）。
@path 将展开为包含项目文件的目录名。

`--dry-run|-n`

进行dry run。不会执行任何命令，也不会对构建图进行永久性更改。

`--keep-going|-k`

在出现错误时继续执行，如果可能的话。

`--less-verbose|-q`

通过减少日志级别来降低输出量。此选项可以多次提供。过多出现没有效果。

如果命令行中除了此选项外还出现了 --log-level 选项，则其值作为减少的基础。

`--log-level <level>`

使用指定的日志级别。

<level> 的可能值为

错误
警告
info（默认值）
调试
跟踪

`--log-time`

记录此命令涉及的操作所需的时间。

此选项在日志级别 debug 及以上时会隐含。

此选项与 --show-progress 互斥。

`--more-verbose|-v`

通过增加日志级别来提高输出量。此选项可以多次提供。过多出现没有效果。

如果命令行中除了此选项外还出现了 --log-level 选项，则其值作为增加的基础。

`--products|-p <name>[,<name>...]`

仅考虑由 <name> 指定的产品以及它们的依赖项。

`--settings-dir <directory>`

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

默认值是针对系统的。例如：

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

`--show-progress`

显示命令执行的进度。

此选项与--log-time是互斥的。

参数

`config:configuration-name`

指定要使用的构建配置。

Qbs一次可以为一个或多个配置构建项目，每个配置都有一个不同的参数集。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 clean