Project Item
A Project item represents a collection of of products. In a non-trivial project, these products are typically defined in their own files and referenced in the main project file:
Project { references: [ "product1/product1.qbs", "product2/product2.qbs" ] }
Any property prop attached to this item is available in sub-items as project.prop.
While the root of the item hierarchy is always a Project, this kind of item can also appear further down the hierarchy. Such sub-projects are ususally introduced to group products. See the SubProject Item for details.
Note: If your project consists of only one product, the Project item can be omitted.
Property | Type | Default | Description |
---|---|---|---|
name | string | basename of the file the project is defined in | The project name. Only relevant for e.g. displaying a project tree in an IDE. |
condition | bool | true | Whether the project is enabled. If false, no products or sub-projects will be collected. |
qbsSearchPaths | stringList | empty | These paths are searched for imports and modules in addition to the ones listed in preferences.qbsSearchPaths. All products in the project inherit this value by default. |
references | path list | empty | A list of files from which to import products. This is equivalent to defining the respective Product items directly under this Project item. |