shell

概要

qbs shell [options] [config:configuration-name] [property:value]

描述

在具有指定参数的构建环境中打开 shell。

有关更多信息，请参阅使用 Shell。

选项

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

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

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

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

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

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

`[--file|-f <file>]`

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

如果没有给出此选项，其行为与 -f <working-dir> 相同。

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

仅考虑通过 <name> 指定的 products 及其依赖项。

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

`property:value`

可以在命令行中覆盖在项目文件或配置文件中设置的属性值。语法是

<prefix>.<property-name>:<property-value>

更多信息，请参阅从命令行覆盖属性值。

示例

打开一个与 Qbs 构建项目时使用相同环境的 shell

qbs shell