产品列表

摘要

qbs list-products [options] [config:configuration-name]

描述

列出项目中存在的所有产品。

选项

[--file|-f <file>]

使用 <file> 作为项目文件。如果 <file> 是一个目录并且它包含一个具有扩展名 .qbs 的单个文件，那么将使用该文件。

如果未给出此选项，则行为与 -f <working-dir> 一样。

--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 之前的参数分配给所有构建配置。在产品和模块内部，可以通过 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 list-products