From 9ee39e514188a455687bfa262071e1afad460e16 Mon Sep 17 00:00:00 2001 From: Leena Miettinen Date: Thu, 23 May 2024 13:55:50 +0200 Subject: [PATCH] Doc: Describe how to add optimized self-built Qt Fixes: QTCREATORBUG-30841 Change-Id: Id5c2fe0fcf925812b9abc8d8f53557aeeb917e32 Reviewed-by: hjk Reviewed-by: Christian Kandeler --- ...dit-cmake-configuration-self-built-qt.webp | Bin 0 -> 8410 bytes .../src/baremetal/creator-baremetal-dev.qdoc | 4 +- .../creator-projects-qt-versions.qdoc | 45 ++++++++++++------ 3 files changed, 34 insertions(+), 15 deletions(-) create mode 100644 doc/qtcreator/images/qtcreator-edit-cmake-configuration-self-built-qt.webp diff --git a/doc/qtcreator/images/qtcreator-edit-cmake-configuration-self-built-qt.webp b/doc/qtcreator/images/qtcreator-edit-cmake-configuration-self-built-qt.webp new file mode 100644 index 0000000000000000000000000000000000000000..820461039e9b2901c49b34f17f5762e961f638f4 GIT binary patch literal 8410 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 literal 0 HcmV?d00001 diff --git a/doc/qtcreator/src/baremetal/creator-baremetal-dev.qdoc b/doc/qtcreator/src/baremetal/creator-baremetal-dev.qdoc index 3df5faba46d..70ded6fc366 100644 --- a/doc/qtcreator/src/baremetal/creator-baremetal-dev.qdoc +++ b/doc/qtcreator/src/baremetal/creator-baremetal-dev.qdoc @@ -23,7 +23,9 @@ applications on them. \note If you use qmake to build the project and the device does not have - Qt libraries, you need a fake Qt installation. + Qt libraries, you need a Qt installation that meets the requirements in + \l{Self-built Qt versions}. In addition, the \c mkspecs directory needs + to be complete enough to parse .pro files. The following toolchains are supported for building applications: diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-qt-versions.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-qt-versions.qdoc index 0b06e1d84c1..48958f8846e 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-qt-versions.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-qt-versions.qdoc @@ -108,28 +108,45 @@ To verify the installation of a particular Qt version, \QC calls \c {qmake -query} and checks that the directories referenced in the - output exist. When \QC complains about the installation of a self-built Qt - version, try running \c {make install} in the build directory to actually - install Qt into the configured location. If you installed Qt using the Qt - Installer, run \QMT to check for updates or to reinstall - the Qt version. + output exist. If you installed Qt using \QOI, run + \QMT to check for updates or to reinstall the Qt version. - \section1 Minimum requirements - If your build of Qt is incomplete but you still want to use qmake as build - system, you need to ensure the following minimum requirements to use that - setup with \QC. + \section2 Self-built Qt versions - \list 1 + To build projects with a self-built Qt version, add it as described in + \l{Set up new Qt versions}. + + Your Qt has to meet the following minimum requirements: + + \list \li qmake is an executable that understands the \c -query command-line argument. \li The \c bin and \c include directories have to exist. \QC fetches these directories by running \c{qmake -query}. - \li The \c mkspecs directory should be complete enough to parse .pro - files. \endlist - If your Qt version has no \c libQtCore.so, \QC cannot detect the ABI. + Add a kit for the Qt version and configure it for CMake. - \sa {kits-tab}{Kits} + \QC issues warnings if: + + \list + \li \c libQtCore.so is missing, so \QC cannot detect the ABI. + \li \c toolchain.cmake is missing. For example, you built Qt with the + \c -static option for an x86 platform. + \endlist + + Try the following: + + \list + \li Run \c {make install} in the build directory to install Qt into the + configured location. + \li Set the value of the \c CMAKE_PREFIX_PATH variable in \preferences > + \uicontrol Kits > \uicontrol Kits > \uicontrol {CMake Configuration} + to the location where you installed Qt. + \endlist + + \image qtcreator-edit-cmake-configuration-self-built-qt.webp {Setting the path to a self-built Qt} + + \sa {Manage Kits}{How To: Manage Kits}, {kits-tab}{Kits} */