diff options
author | Joerg Bornemann <joerg.bornemann@qt.io> | 2021-10-21 17:39:07 +0200 |
---|---|---|
committer | Joerg Bornemann <joerg.bornemann@qt.io> | 2021-10-22 10:11:50 +0200 |
commit | 50ecd291d2ed85f7bf7f19b09b23011798687493 (patch) | |
tree | 080161f652ede30e4fd53fa669ac17ff97517b2a /doc/src/platforms/configure-linux-device.qdoc | |
parent | 2aa2a3633137da4ee64461d85c1ffe56d3052914 (diff) |
Do not recommend QT_BUILD_TOOLS_WHEN_CROSSCOMPILING
QT_BUILD_TOOLS_WHEN_CROSSCOMPILING was recommended for cross-compiling,
because otherwise qml, qmlscene and qmlpreview were not built for the
device. Those tools are user-facing tools, and it was a bug that they
were not built for the target. This is fixed since
qtdeclarative/3e2a85384b1f5454e51a27827114e49746f8837a, and the
recommendation is now invalid.
Pick-to: 6.2
Change-Id: Id1b9962ec1c307d9665e798acbb4be8c4cedfc2f
Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
Diffstat (limited to 'doc/src/platforms/configure-linux-device.qdoc')
-rw-r--r-- | doc/src/platforms/configure-linux-device.qdoc | 12 |
1 files changed, 5 insertions, 7 deletions
diff --git a/doc/src/platforms/configure-linux-device.qdoc b/doc/src/platforms/configure-linux-device.qdoc index 14f521760..2c484a820 100644 --- a/doc/src/platforms/configure-linux-device.qdoc +++ b/doc/src/platforms/configure-linux-device.qdoc @@ -147,8 +147,7 @@ -qt-host-path $HOME/qt-host \ -extprefix $HOME/qt6-rpi \ -prefix /usr/local/qt6 \ - -- -DCMAKE_TOOLCHAIN_FILE=$HOME/qt-cross/toolchain.cmake \ - -DQT_BUILD_TOOLS_WHEN_CROSSCOMPILING=ON + -- -DCMAKE_TOOLCHAIN_FILE=$HOME/qt-cross/toolchain.cmake \endcode In practice this configure command is equivalent to the following direct CMake call: @@ -159,7 +158,6 @@ -DCMAKE_STAGING_PREFIX=$HOME/qt6-rpi \ -DCMAKE_INSTALL_PREFIX=/usr/local/qt6 \ -DCMAKE_TOOLCHAIN_FILE=$HOME/qt-cross/toolchain.cmake \ - -DQT_BUILD_TOOLS_WHEN_CROSSCOMPILING=ON \ $HOME/qt-cross/qtbase \endcode @@ -177,10 +175,10 @@ ... \endcode - Enabling \c{QT_BUILD_TOOLS_WHEN_CROSSCOMPILING} is optional. If only the Qt libraries, - and no associated tools, are desired for the target device, then it can be left - out. However, enabling it is often a good idea, because it will lead to building - binaries of tools meant to be run on the target device, such as \c qml and \c qmlpreview. + By default, when cross-compiling, only the Qt libraries and tools that are + supposed to run on the target device are built. Build-related tools like \c + moc and \c uic are not built. Building such tools can be enabled by setting + \c{QT_BUILD_TOOLS_WHEN_CROSSCOMPILING} to \c{ON}. \note When \c{QT_BUILD_TOOLS_WHEN_CROSSCOMPILING} is enabled, target binaries of tools like \c qmake will get installed to the staging location. Therefore, if \c qmake is |