dump-nodes-tree

概要

qbs dump-nodes-tree [options] [config:configuration-name]

描述

将构建图中的节点输出到 stdout。

这是一个仅用于调试目的的内部命令。

选项

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

指定存储构建工件的项目文件夹。

如果未设置 preferences.defaultBuildDirectory，默认值为当前文件夹。

相对路径将相对于当前文件夹进行解析。

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

@project 被扩展为项目文件名称，不包括扩展名 .qbs。
@path 被扩展为包含项目文件的目录名。

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

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

`--settings-dir <directory>`

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

默认值是系统特定的。例如：

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

参数

`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)、下划线 (_) 或美元符号 ($)。
后续字符可以是字母、数字、下划线或美元符号。

示例

将节点树导出到名为 nodes-tree.log 的文件中

qbs dump-nodes-tree >nodes-tree.log