diff options
author | Joerg Bornemann <joerg.bornemann@qt.io> | 2021-10-21 17:39:07 +0200 |
---|---|---|
committer | Qt Cherry-pick Bot <cherrypick_bot@qt-project.org> | 2021-10-22 08:50:15 +0000 |
commit | 1ea6650da4b41b8b7004b3ee713d3680629b1e65 (patch) | |
tree | 3215574a82948c7e717c7381123c1fccacf19c12 | |
parent | d72448410b5062060f066236b85a6666d40c1eef (diff) | |
download | qtdoc-1ea6650da4b41b8b7004b3ee713d3680629b1e65.tar.gz |
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.
Change-Id: Id1b9962ec1c307d9665e798acbb4be8c4cedfc2f
Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
(cherry picked from commit 50ecd291d2ed85f7bf7f19b09b23011798687493)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
-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 c64320da..5d7e3f6d 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 |