qt5base-lts/examples
Craig Scott d97fd7af2b Build examples in isolated sub-builds using ExternalProject
Examples are intended to show how to build against an installed Qt.
Building them as part of the main build means the way the Qt targets
are defined and created are not representative of an end user's build.
By building them as separate projects using ExternalProject, we can
more closely replicate the intended audience's environment. This
should allow us to catch more problems earlier.

Having examples built as part of the main build also creates problems
with some static builds where a tool built by the main build is needed
during configure time. This happens with other repos like qtdeclarative
but not (currently) with qtbase. Converting the examples in qtbase to
be built using ExternalProject is intended as a demonstrator for how
other repos can do similar. Until other repos are converted, they will
continue to work as they did before, with examples as part of the main
build for non-static builds only.

The new build-externally behavior is only supported for non-prefix
builds with this change. Prefix builds will continue to use the old
non-external method. Support for building examples externally in
prefix builds will be a separate change.

Task-number: QTBUG-90820
Fixes: QTBUG-91068
Change-Id: I2304329940568dbdb7da18d54d5595ea7d8668bc
Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2021-05-26 13:33:29 +02:00
..
aggregate install a sane top-level examples.pro file 2012-12-11 13:37:57 +01:00
corelib Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
dbus Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
embedded Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
gui Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
network Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
opengl Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
qmake Another round of replacing 0 with nullptr 2020-10-07 23:02:47 +02:00
qpa Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
qtconcurrent Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
qtestlib Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
sql Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
vulkan Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
widgets Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
xml Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
CMakeLists.txt Build examples in isolated sub-builds using ExternalProject 2021-05-26 13:33:29 +02:00
examples.pro Turn off the dbus examples for qmake-generated VS projects 2021-02-09 15:45:06 +01:00
README Remove more references to demos. 2011-07-08 15:36:26 +02:00

Qt is supplied with a number of example applications that have been
written to provide developers with examples of the Qt API in use,
highlight good programming practice, and showcase features found in each of
Qt's core technologies.


Documentation for examples can be found in the Examples section
of the Qt documentation.