resolve

摘要

qbs resolve [options] [[config:configuration-name] [property:value] ...]

描述

将一个或多个配置中的项目解决。运行此命令以更改现有构建的属性。

选项

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

指定一个<directory>，其中存储了构建工件。

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

相对路径将相对于当前目录进行解释。

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

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

`--dry-run|-n`

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

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

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

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

`--force-probe-execution`

强制重新执行所有探查器项目配置脚本，而不是使用缓存的数据。

`--less-verbose|-q`

通过将日志级别降低一个级别而变得更加安静。此选项可以多次给出。过多的发生没有效果。

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

`--log-level <level>`

使用指定的日志级别。

<level> 的可能值是

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

`--log-time`

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

此选项在日志级别 debug 及更高级别时隐含。

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

`--more-verbose|-v`

通过将日志级别提高一个级别而变得更加详细。此选项可以多次给出。过多的发生没有效果。

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

`--settings-dir <目录>`

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

默认值由系统特定。例如

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

`--show-progress`

显示命令执行的进度。

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

`--no-fallback-module-provider`

如果设置此选项，则当找不到依赖项时，Qbs不会回退到基于pkg-config的模块提供程序。

`--deprecation-warnings <模式>`

使用指定的弃用警告模式，用于控制在项目中遇到弃用项或属性时执行的操作。默认情况下，如果项目项或属性计划在Qbs下一个次要版本中删除，则会发出警告。也可以无条件地启动或关闭警告，并可以指定如果项目中存在弃用结构，则项目解析应中止。

<模式>的可能值

错误
开启
before-removal（默认值）
关闭

参数

`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 resolve