create-project

Synopsis

qbs create-project [--blacklist <blacklist>] [--whitelist <whitelist>]
                   [--flat]

Description

Automatically generates Qbs project files from an arbitrary directory structure. You can filter the files to add to the project by blacklisting or whitelisting them. The command creates nested project files, unless you use the --flat option.

This is a useful starting point when migrating from other build tools, such as qmake or CMake.

Note: Run this command from the project directory.

After generating the initial .qbs files, add the missing configuration variables and functions to them.

Options

--blacklist <blacklist>

Ignores files whose names match the patterns specified by <blacklist>. The list entries can contain wildcards and are separated by commas.

By default, no files are ignored.

--whitelist <whitelist>

Considers only files whose names match the patterns specified by <whitelist>. The list entries can contain wildcards and are separated by commas.

By default, all files are considered.

--flat

Does not create nested project files, even if there are subdirectories and the top-level directory does not contain any files.

--help|-h|-?

Displays help for the command.

Examples

Creates .qbs files in the project directory when run from there:

qbs create-project

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