qbs status [options] [config:configuration-name]
Lists all the files in the project directory and shows whether they are known to Qbs in the respective configuration.
<directory> where build artifacts are stored.
The default value is the current directory unless
preferences.defaultBuildDirectory is set.
Relative paths will be interpreted relative to the current directory.
You can use the following special values as placeholders:
@projectis expanded to the name of the project file excluding the extension
@pathis expanded to the name of the directory containing the project file.
Reads all settings (such as profile information) from the specified
<directory>. If the directory does not exist, it will be created.
The default value is system-specific. For example:
Specifies the build configuration to use.
Qbs can build a project for one or multiple configurations at once, each having a different set of parameters. The
config parameter has a special function: with each occurrence a new configuration instance begins and all subsequent parameters until the next
config are assigned to this instance. Parameter assignments before the first occurrence of
config are applied to all build configurations. Inside products and modules, the current active build configuration can be retrieved via qbs.configurationName.
In the following snippet, a profile
clang is applied to all configurations while
cpp.optimization is different for
profile:clang config:debug cpp.optimization:none config:release cpp.optimization:small
The value of
config determines the name of the build folder and affects the default value of the qbs.buildVariant property. Qbs knows the
"release", but in general any name can be chosen. When naming configurations created for special purposes, follow the rules for legal names generally used in programming languages:
- The first character must be a letter (a-z), an underscore (_), or a dollar sign ($).
- Subsequent characters may be letters, digits, underscores, or dollar signs.
To list the files in the project directory and view their status:
© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.