diff options
| author | Jake Petroules <jake.petroules@qt.io> | 2016-06-10 23:31:05 -0700 |
|---|---|---|
| committer | Jake Petroules <jake.petroules@qt.io> | 2016-06-20 07:22:56 +0000 |
| commit | 532e8ea991cf0dede72d3f357619f49f4b36187b (patch) | |
| tree | 048ac18f8d5105eae0e56e666345e892f7467bf9 /doc | |
| parent | e55b41dde5789bd45164555f2bddc0a8fe15771d (diff) | |
Stop special casing qbs.buildVariant in command line handling.
This introduces qbs.configurationName, which takes the place of
qbs.buildVariant in the command line and acts as a unique identifier
for each build configuration, rather than relying on the combination of
qbs.buildVariant and the profile name to do so.
No longer special casing qbs.buildVariant allows the variant to be
decoupled from the build configuration, and allow scenarios where a
project may contain products hardcoded for particular build variants,
and in future, special debug-and-release builds which create a single
framework product containing multiple build variants.
Incidentally, this change allows building multiple configurations of the
same build variant and profile name combination, since the build
configuration is no longer keyed on the aggregate of those values.
Building for different profiles with the same configuration name in
parallel is now no longer possible, but this is easily worked around by
simply specifying different configuration names for such combinations.
For example, the following is now possible:
qbs \
static profile:a qbs.buildVariant:release project.useStaticLibraries:true \
dynamic profile:a qbs.buildVariant:release project.useStaticLibraries:false
[ChangeLog] Each build configuration now requires a unique name, which
is specified on the command line in the same place that qbs.buildVariant
used to be specified. This allows building for multiple configurations
with the same variant.
Change-Id: I96ab9fc96861ab7e6a04a7d291a093115c22010e
Reviewed-by: Christian Kandeler <christian.kandeler@theqtcompany.com>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Jake Petroules <jake.petroules@qt.io>
Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/qbs.qdoc | 5 | ||||
| -rw-r--r-- | doc/reference/modules/qbs-module.qdoc | 6 |
2 files changed, 8 insertions, 3 deletions
diff --git a/doc/qbs.qdoc b/doc/qbs.qdoc index 8e09f22df..d85f992e6 100644 --- a/doc/qbs.qdoc +++ b/doc/qbs.qdoc @@ -520,14 +520,13 @@ "ios", "android", "blackberry", "qnx", etc. \endtable - You can set these properties on the command line or by using a profile. The property \a - qbs.buildVariant is handled in a special way. + You can set these properties on the command line or by using a profile. \code $ qbs # qbs.buildVariant:debug, profile:<default profile> $ qbs release # qbs.buildVariant:release, profile:<default profile> $ qbs profile:Maemo # qbs.buildVariant:debug, profile:Maemo - $ qbs debug release # builds two variants of the project + $ qbs debug release # builds two configurations of the project \endcode To select files by build variant: diff --git a/doc/reference/modules/qbs-module.qdoc b/doc/reference/modules/qbs-module.qdoc index 11b7246f7..da5034412 100644 --- a/doc/reference/modules/qbs-module.qdoc +++ b/doc/reference/modules/qbs-module.qdoc @@ -50,6 +50,12 @@ \li Default \li Description \row + \li configurationName + \li \c{string} + \li 1.6 + \li \c{"default"} + \li Contains the name of the current build configuration. + \row \li buildVariant \li \c{string} \li 1.0 |