更新时间戳

概述

qbs update-timestamps [options] [config:configuration-name] ...

描述

更新所有构建工件的时间戳，导致下一个项目的构建在源文件再次更新之前不做任何事情。

如果您知道当前对源文件的更改与构建无关，则此命令很有用。

选项

--build-directory|-d <directory>

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

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

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

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

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

--less-verbose|-q

通过减少日志级别来减少输出。此选项可以多次给定。过多的实例没有效果。

如果命令行中还包括此选项外 --log-level 选项，则其值用作减少的基数。

--log-level <level>

使用指定的日志级别。

可能的 <level> 值有

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

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

参数

config:配置名称

指定要使用的构建配置。

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>

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

示例