diff --git a/doc/qtdesignstudio/images/icons/close.png b/doc/qtcreator/images/icons/close.png similarity index 100% rename from doc/qtdesignstudio/images/icons/close.png rename to doc/qtcreator/images/icons/close.png diff --git a/doc/qtcreator/images/qmldesigner-run-custom-exe.png b/doc/qtcreator/images/qmldesigner-run-custom-exe.png deleted file mode 100644 index c30f6d21857..00000000000 Binary files a/doc/qtcreator/images/qmldesigner-run-custom-exe.png and /dev/null differ diff --git a/doc/qtcreator/images/qmldesigner-run-settings.png b/doc/qtcreator/images/qmldesigner-run-settings.png deleted file mode 100644 index 457a1a9286a..00000000000 Binary files a/doc/qtcreator/images/qmldesigner-run-settings.png and /dev/null differ diff --git a/doc/qtcreator/images/qtcreator-cmake-build-steps.webp b/doc/qtcreator/images/qtcreator-cmake-build-steps.webp index d90c97cb81f..dc05bbb67d9 100644 Binary files a/doc/qtcreator/images/qtcreator-cmake-build-steps.webp and b/doc/qtcreator/images/qtcreator-cmake-build-steps.webp differ diff --git a/doc/qtcreator/images/qtcreator-run-settings-custom-executable.webp b/doc/qtcreator/images/qtcreator-run-settings-custom-executable.webp new file mode 100644 index 00000000000..66dfb298a87 Binary files /dev/null and b/doc/qtcreator/images/qtcreator-run-settings-custom-executable.webp differ diff --git a/doc/qtcreator/images/qtquick-ui-prototype-run-settings.webp b/doc/qtcreator/images/qtquick-ui-prototype-run-settings.webp new file mode 100644 index 00000000000..7f564c475ca Binary files /dev/null and b/doc/qtcreator/images/qtquick-ui-prototype-run-settings.webp differ diff --git a/doc/qtcreator/src/analyze/creator-valgrind-overview.qdoc b/doc/qtcreator/src/analyze/creator-valgrind-overview.qdoc index bd3d21f7516..61aca06cfd2 100644 --- a/doc/qtcreator/src/analyze/creator-valgrind-overview.qdoc +++ b/doc/qtcreator/src/analyze/creator-valgrind-overview.qdoc @@ -50,4 +50,5 @@ \endlist + \sa {Specify Valgrind settings for a project} */ diff --git a/doc/qtcreator/src/android/creator-projects-settings-run-android.qdocinc b/doc/qtcreator/src/android/creator-projects-settings-run-android.qdoc similarity index 63% rename from doc/qtcreator/src/android/creator-projects-settings-run-android.qdocinc rename to doc/qtcreator/src/android/creator-projects-settings-run-android.qdoc index 6d0b5cc17ad..6cde1d3537f 100644 --- a/doc/qtcreator/src/android/creator-projects-settings-run-android.qdocinc +++ b/doc/qtcreator/src/android/creator-projects-settings-run-android.qdoc @@ -1,16 +1,27 @@ -// Copyright (C) 2021 The Qt Company Ltd. +// Copyright (C) 2023 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! -//! [run settings android] + \page creator-run-settings-android.html + \previouspage creator-reference.html - \section1 Specifying Run Settings for Android Devices + \ingroup creator-reference-run-configurations + + \title Android Run Settings + + \brief Settings for running applications on Android devices. + + Specify settings for running applications on the \l {Kits}{Run device} that + you select for a kit in \uicontrol Projects > \uicontrol {Build & Run} > + \uicontrol Run > \uicontrol {Run Settings}. To run and debug an application on an Android device, you must create connections from the development host to the device, as instructed in \l {Connecting Android Devices}. - A default set of Android Activity manager (am) start options is applied when + \section1 am Start Options + + \QC applies a default set of Android Activity manager (am) start options when starting applications. You can specify additional start options in the \uicontrol {Activity manager start arguments} field. However, if the default options conflict with the added options, the application might not start. @@ -30,10 +41,12 @@ For example, to run the application as a particular user, enter the start option \c {--user 10}, where \c 10 is the user ID of the user account. - \image qtcreator-android-run-settings.png + \image qtcreator-android-run-settings.png {Run Settings for an Android device} - You can specify shell commands to run before the application is started - and after it is quit. For example, enter the following commands into + \section1 Shell Commands + + You can specify shell commands to run before the application starts + and after it quits. For example, enter the following commands into \uicontrol{Pre-launch on-device shell commands} to unlock the screen and to switch to the user account \c 10 on the device before running the application: @@ -52,5 +65,6 @@ input keyevent 82 \endcode -//! [run settings android] + \sa {Activate kits for a project}, {Configure projects for running}, + {Connecting Android Devices} */ diff --git a/doc/qtcreator/src/android/deploying-android.qdoc b/doc/qtcreator/src/android/deploying-android.qdoc index 0e1c2e7fde7..2926d7739bd 100644 --- a/doc/qtcreator/src/android/deploying-android.qdoc +++ b/doc/qtcreator/src/android/deploying-android.qdoc @@ -36,7 +36,7 @@ \uicontrol {Build Android APK} > \uicontrol Details. For more information about options that you have for running applications, - see \l {Specifying Run Settings for Android Devices}. + see \l {Android Run Settings}. \section1 Packaging Applications @@ -65,7 +65,7 @@ \uicontrol Manage. For more information about specifying additional start options for - applications, see \l{Specifying Run Settings for Android Devices}. + applications, see \l{Android Run Settings}. To remove previously installed files from the device, select \uicontrol {Uninstall the existing app before deployment}. diff --git a/doc/qtcreator/src/cmake/creator-projects-cmake-building.qdoc b/doc/qtcreator/src/cmake/creator-projects-cmake-building.qdoc index 9c971d24798..e5fedd06d60 100644 --- a/doc/qtcreator/src/cmake/creator-projects-cmake-building.qdoc +++ b/doc/qtcreator/src/cmake/creator-projects-cmake-building.qdoc @@ -2,19 +2,26 @@ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! - \previouspage creator-build-settings.html \page creator-build-settings-cmake.html - \nextpage creator-build-settings-cmake-presets.html + \previouspage creator-reference.html + + \ingroup creator-reference-build-configurations \title CMake Build Configuration + \brief Settings for building applications with CMake. + + Specify build settings for the selected \l{glossary-buildandrun-kit}{kit} in + \uicontrol Projects > \uicontrol {Build & Run} > \uicontrol Build > + \uicontrol {Build Settings}. + Configuring medium-sized to large CMake projects in \QC can be a challenge due to the number of variables that you need to pass to CMake to configure the project correctly. To make this easier, \QC creates an initial configuration for you based on the kit settings and displays it in \uicontrol {Initial Configuration} in - the \l{Specifying Build Settings}{Build Settings} of the project. - Alternatively, you can use CMake presets to configure CMake. + the \uicontrol {Build Settings} of the project. + Or, you can use CMake presets to configure CMake. The \uicontrol Configure field displays the effective CMake call that \QC constructs using the values of the \uicontrol {Build directory} and @@ -257,4 +264,7 @@ \image qtcreator-cmake-clean-steps.webp {CMake clean steps} The build errors and warnings are parsed and displayed in \l Issues. + + \sa {Activate kits for a project}, {Configure projects for building}, + {Configure projects for running}, {Open projects}, {CMake} */ diff --git a/doc/qtcreator/src/cmake/creator-projects-cmake-presets.qdoc b/doc/qtcreator/src/cmake/creator-projects-cmake-presets.qdoc index 3a51034199e..050b0b1f8c7 100644 --- a/doc/qtcreator/src/cmake/creator-projects-cmake-presets.qdoc +++ b/doc/qtcreator/src/cmake/creator-projects-cmake-presets.qdoc @@ -2,12 +2,15 @@ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! - \previouspage creator-build-settings-cmake.html \page creator-build-settings-cmake-presets.html - \nextpage creator-build-settings-qmake.html + \previouspage creator-reference.html + + \ingroup creator-reference-build-configurations \title CMake Presets + \brief Examples of supported CMake presets. + \c CMakePresets.json has options for project-wide builds, whereas \c CMakeUserPresets.json has options for your local builds. @@ -224,4 +227,6 @@ ] } \endcode + + \sa {CMake Build Configuration}, {CMake} */ diff --git a/doc/qtcreator/src/cmake/creator-projects-cmake.qdoc b/doc/qtcreator/src/cmake/creator-projects-cmake.qdoc index 3d2babbc53c..78bd0e54ea2 100644 --- a/doc/qtcreator/src/cmake/creator-projects-cmake.qdoc +++ b/doc/qtcreator/src/cmake/creator-projects-cmake.qdoc @@ -47,10 +47,9 @@ Typically, you cannot compile such projects without manual changes. \endlist - \sa {Build with CMake}{How To: Build with CMake}, {Open projects}, - {CMake Build Configuration}, {Debug CMake project files}, - {Specifying Build Settings}, {Specifying Run Settings}, - {Deploying to Remote Linux} + \sa {Build with CMake}{How To: Build with CMake}, {CMake Build Configuration}, + {Configure projects for building}, {Configure projects for running}, + {Debug CMake project files}, {Deploying to Remote Linux}, {Open projects} */ /*! diff --git a/doc/qtcreator/src/editors/creator-only/creator-compilation-database.qdocinc b/doc/qtcreator/src/editors/creator-only/creator-compilation-database.qdocinc index d7e74fc9128..68b16bc25be 100644 --- a/doc/qtcreator/src/editors/creator-only/creator-compilation-database.qdocinc +++ b/doc/qtcreator/src/editors/creator-only/creator-compilation-database.qdocinc @@ -31,10 +31,10 @@ \uicontrol C++ > \uicontrol {Switch Header/Source}. You can specify custom build steps and run settings for compilation - database projects in the \uicontrol Projects mode. For more information, - see \l{Adding Custom Build Steps} and \l {Specifying Run Settings}. + database projects in the \uicontrol Projects mode. - \sa {Enable and disable plugins} + \sa {Enable and disable plugins}, {Add custom build steps}, + {Configure projects for running} //! [using compilation databases] */ diff --git a/doc/qtcreator/src/howto/creator-only/creator-autotest.qdoc b/doc/qtcreator/src/howto/creator-only/creator-autotest.qdoc index 544c3274aa0..701a5f99fd4 100644 --- a/doc/qtcreator/src/howto/creator-only/creator-autotest.qdoc +++ b/doc/qtcreator/src/howto/creator-only/creator-autotest.qdoc @@ -438,7 +438,7 @@ or select \uicontrol {Reset Cached Choices}. Select the \uicontrol {Process arguments} check box to pass arguments to the - test executable that you specify in the \l {Managing Run Configurations} + test executable that you specify in the \l {Configure projects for running} {run configuration}. This is an experimental feature that might cause the execution of the test executable to fail. diff --git a/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc b/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc index 98ed0545454..8ebcee37ad1 100644 --- a/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc +++ b/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc @@ -37,6 +37,10 @@ \generatelist creator-how-to-build-with-qmake + \section2 Run applications + + \generatelist creator-how-to-run + \section1 Debug \generatelist creator-how-to-debug diff --git a/doc/qtcreator/src/incredibuild/creator-projects-incredibuild-building.qdoc b/doc/qtcreator/src/incredibuild/creator-projects-incredibuild-building.qdoc index 92ff58fec36..117ac6d6ad7 100644 --- a/doc/qtcreator/src/incredibuild/creator-projects-incredibuild-building.qdoc +++ b/doc/qtcreator/src/incredibuild/creator-projects-incredibuild-building.qdoc @@ -1,12 +1,19 @@ -// Copyright (C) 2021 The Qt Company Ltd. +// Copyright (C) 2023 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! - \previouspage creator-build-settings-meson.html \page creator-build-settings-incredibuild.html - \nextpage creator-build-settings-conan.html + \previouspage creator-reference.html + + \ingroup creator-reference-build-configurations \title IncrediBuild Build Configuration + \brief Build and clean steps for Incredibuild. + + Specify build settings for the selected \l{glossary-buildandrun-kit}{kit} in + \uicontrol Projects > \uicontrol {Build & Run} > \uicontrol Build > + \uicontrol {Build Settings}. + You can specify build steps and clean steps for IncrediBuild. For more information about configuring IncrediBuild, see @@ -114,10 +121,11 @@ \section1 IncrediBuild Clean Steps When building with IncrediBuild, you can add arguments and targets for the - clean command in \uicontrol {Clean Steps}. For more information, see - \l{Clean Steps}. - - For more information about the settings, see \l{IncrediBuild Build Steps}. + clean command in \uicontrol {Clean Steps}. The build errors and warnings are parsed and displayed in \l Issues. + + \sa {Activate kits for a project}, {Add clean steps}, + {Configure projects for building}, {Configure projects for running}, + {Open projects}, {Configuring projects}, {Setting Up IncrediBuild} */ diff --git a/doc/qtcreator/src/linux-mobile/b2qtdev.qdoc b/doc/qtcreator/src/linux-mobile/b2qtdev.qdoc index def1727a1fc..d21656bf72f 100644 --- a/doc/qtcreator/src/linux-mobile/b2qtdev.qdoc +++ b/doc/qtcreator/src/linux-mobile/b2qtdev.qdoc @@ -146,6 +146,6 @@ When you run the project, \QC deploys the application as specified by the deploy steps. By default, \QC copies the application files to the device. For more information, see - \l{Specifying Run Settings for Boot2Qt Devices}. + \l{Boot2Qt Run Settings}. \endlist */ diff --git a/doc/qtcreator/src/linux-mobile/creator-embedded-platforms.qdoc b/doc/qtcreator/src/linux-mobile/creator-embedded-platforms.qdoc index 1d6ec78e30e..52139f5d1bb 100644 --- a/doc/qtcreator/src/linux-mobile/creator-embedded-platforms.qdoc +++ b/doc/qtcreator/src/linux-mobile/creator-embedded-platforms.qdoc @@ -58,7 +58,7 @@ \li \l{https://doc.qt.io/Boot2Qt/b2qt-installation-guides.html} {Boot2Qt: Installation Guides} \li \l{Connecting Boot2Qt Devices} - \li \l{Specifying Run Settings for Boot2Qt Devices} + \li \l{Boot2Qt Run Settings} \li \l{Deploying to Boot2Qt} \li \l{https://doc.qt.io/qtcreator/creator-overview-qtasam.html} {Qt Creator Plugin for Qt Application Manager} @@ -75,7 +75,7 @@ \list \li \l{Connecting Remote Linux Devices} \li \l{Deploying to Remote Linux} - \li \l{Specifying Run Settings for Linux-Based Devices} + \li \l{Remote Linux Run Settings} \li \l{Running on Remote Linux Devices} \li \l{https://doc.qt.io/qtcreator/creator-overview-qtasam.html} {Qt Creator Plugin for Qt Application Manager} @@ -109,7 +109,7 @@ \list \li \l{Connecting QNX Devices} \li \l{Deploying to QNX Neutrino} - \li \l{Specifying Run Settings for QNX Devices} + \li \l{QNX Run Settings} \li \l{Running on QNX Devices} \li \l{Qt for QNX} \endlist diff --git a/doc/qtcreator/src/linux-mobile/creator-projects-running-generic-linux.qdocinc b/doc/qtcreator/src/linux-mobile/creator-projects-running-generic-linux.qdocinc index d2d78806999..995ad8ce4b9 100644 --- a/doc/qtcreator/src/linux-mobile/creator-projects-running-generic-linux.qdocinc +++ b/doc/qtcreator/src/linux-mobile/creator-projects-running-generic-linux.qdocinc @@ -28,7 +28,7 @@ In the \uicontrol {Projects} mode, select the remote Linux kit and then select \uicontrol {Run} to view the settings for deploying the application to the connected device. For more information, see - \l{Specifying Run Settings for Linux-Based Devices}. + \l{Remote Linux Run Settings}. Debugging works transparently if GDB server is installed on the device and it is compatible with the GDB on the host. diff --git a/doc/qtcreator/src/linux-mobile/creator-projects-settings-run-b2qt.qdoc b/doc/qtcreator/src/linux-mobile/creator-projects-settings-run-b2qt.qdoc new file mode 100644 index 00000000000..6b94fd432cc --- /dev/null +++ b/doc/qtcreator/src/linux-mobile/creator-projects-settings-run-b2qt.qdoc @@ -0,0 +1,30 @@ +// Copyright (C) 2023 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \page creator-run-settings-boot2qt.html + \previouspage creator-reference.html + + \ingroup creator-reference-run-configurations + + \title Boot2Qt Run Settings + + \brief Settings for running applications on Boot2Qt devices. + + Specify settings for running applications on the \l {Kits}{Run device} that + you select for a kit in \uicontrol Projects > \uicontrol {Build & Run} > + \uicontrol Run > \uicontrol {Run Settings}. + + To run and debug an application on a \l Boot2Qt device (commercial only), you + must create connections from the development host to the device and add the + device configurations to kits. Select \uicontrol {Manage Kits} to add devices + to kits. For more information, see + \l{http://doc.qt.io/Boot2Qt/b2qt-installation-guides.html} + {Boot2Qt: Installation Guide}. + + The run settings display the path to the executable file on the development + host and on the device. + + \sa {Activate kits for a project}, {Configure projects for running}, {Kits}, + {Deploying to Boot2Qt} +*/ diff --git a/doc/qtcreator/src/linux-mobile/creator-projects-settings-run-b2qt.qdocinc b/doc/qtcreator/src/linux-mobile/creator-projects-settings-run-b2qt.qdocinc deleted file mode 100644 index 2683006f52c..00000000000 --- a/doc/qtcreator/src/linux-mobile/creator-projects-settings-run-b2qt.qdocinc +++ /dev/null @@ -1,23 +0,0 @@ -// Copyright (C) 2021 The Qt Company Ltd. -// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only - -/*! -//! [run settings boot2qt] - - \section1 Specifying Run Settings for Boot2Qt Devices - - To run and debug an application on a \l Boot2Qt device (commercial only), you - must create connections from the development host to the device and add the - device configurations to \l{glossary-buildandrun-kit}{kits}. Select - \uicontrol {Manage Kits} to add devices to kits. For more information, see - \l{http://doc.qt.io/Boot2Qt/b2qt-installation-guides.html} - {Boot2Qt: Installation Guide}. - - The run settings display the path to the executable file on the development - host and on the device. - - For more information on the deployment steps, see - \l{Deploying to Boot2Qt}. - -//! [run settings boot2qt] -*/ diff --git a/doc/qtcreator/src/linux-mobile/creator-projects-settings-run-linux.qdocinc b/doc/qtcreator/src/linux-mobile/creator-projects-settings-run-linux.qdoc similarity index 53% rename from doc/qtcreator/src/linux-mobile/creator-projects-settings-run-linux.qdocinc rename to doc/qtcreator/src/linux-mobile/creator-projects-settings-run-linux.qdoc index ea58383ea44..9294c9a920f 100644 --- a/doc/qtcreator/src/linux-mobile/creator-projects-settings-run-linux.qdocinc +++ b/doc/qtcreator/src/linux-mobile/creator-projects-settings-run-linux.qdoc @@ -1,15 +1,23 @@ -// Copyright (C) 2020 The Qt Company Ltd. +// Copyright (C) 2023 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! -//! [run settings linux] + \page creator-run-settings-remote-linux.html + \previouspage creator-reference.html - \section1 Specifying Run Settings for Linux-Based Devices + \ingroup creator-reference-run-configurations - To run and debug an application on a Linux-based device, - you must create connections from the development - host to the device and add the device configurations to - \l{glossary-buildandrun-kit}{kits}. Click \uicontrol {Manage Kits} to add devices + \title Remote Linux Run Settings + + \brief Settings for running applications on Linux-based devices. + + Specify run settings for the selected \l{glossary-buildandrun-kit}{kit} in + \uicontrol Projects > \uicontrol {Build & Run} > \uicontrol Run > + \uicontrol {Run Settings}. + + To run and debug an application on a Linux-based device, you must create + connections from the development host to the device and add the device + configurations to kits. Select \uicontrol {Manage Kits} to add devices to kits. For more information, see \l {Connecting Remote Linux Devices}. @@ -29,5 +37,6 @@ Select the \uicontrol {Forward to local display} check box to show a remotely running X11 client on a local display. -//! [run settings linux] + \sa {Activate kits for a project}, {Configure projects for running}, {Kits}, + {Connecting Remote Linux Devices} */ diff --git a/doc/qtcreator/src/meson/creator-projects-meson-building.qdoc b/doc/qtcreator/src/meson/creator-projects-meson-building.qdoc index 671a93c48d7..f5f6f694c06 100644 --- a/doc/qtcreator/src/meson/creator-projects-meson-building.qdoc +++ b/doc/qtcreator/src/meson/creator-projects-meson-building.qdoc @@ -1,13 +1,20 @@ // Copyright (C) 2022 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! - \previouspage creator-build-settings-qbs.html \page creator-build-settings-meson.html - \nextpage creator-build-settings-incredibuild.html + \previouspage creator-reference.html + + \ingroup creator-reference-build-configurations \title Meson Build Configuration - \image qtcreator-meson-build-settings.png "Meson build settings" + \brief Settings for building applications with Meson. + + Specify build settings for the selected \l{glossary-buildandrun-kit}{kit} in + \uicontrol Projects > \uicontrol {Build & Run} > \uicontrol Build > + \uicontrol {Build Settings}. + + \image qtcreator-meson-build-settings.png {Meson build settings} Meson builds projects in the directory specified in the \uicontrol {Build directory} field. @@ -35,7 +42,7 @@ You can add arguments and targets for the build command in \uicontrol {Build Steps}. - \image qtcreator-meson-build-steps.png "Meson build steps" + \image qtcreator-meson-build-steps.png {Meson build steps} The build errors and warnings are parsed and displayed in \l Issues. @@ -44,8 +51,10 @@ When building with Meson, you can add arguments and targets for the clean command in \uicontrol {Clean Steps}. - \image qtcreator-meson-clean-steps.png "Meson clean steps" + \image qtcreator-meson-clean-steps.png {Meson clean steps} The build errors and warnings are parsed and displayed in \uicontrol Issues. + \sa {Activate kits for a project}, {Configure projects for building}, + {Configure projects for running}, {Open projects}, {Configuring projects} */ diff --git a/doc/qtcreator/src/overview/creator-only/creator-reference.qdoc b/doc/qtcreator/src/overview/creator-only/creator-reference.qdoc index 2408b7f1828..b5265401891 100644 --- a/doc/qtcreator/src/overview/creator-only/creator-reference.qdoc +++ b/doc/qtcreator/src/overview/creator-only/creator-reference.qdoc @@ -19,6 +19,14 @@ \annotatedlist creator-reference-build-systems + \section1 Build Configurations + + \annotatedlist creator-reference-build-configurations + + \section1 Run Configurations + + \annotatedlist creator-reference-run-configurations + \section1 Preferences \annotatedlist creator-reference-preferences diff --git a/doc/qtcreator/src/projects/creator-only/creator-build-settings-qmake.qdoc b/doc/qtcreator/src/projects/creator-only/creator-build-settings-qmake.qdoc index ea95ce05924..18906bee8d5 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-build-settings-qmake.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-build-settings-qmake.qdoc @@ -2,23 +2,28 @@ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! - \previouspage creator-build-settings-cmake-presets.html \page creator-build-settings-qmake.html - \nextpage creator-build-settings-qbs.html + \previouspage creator-reference.html + + \ingroup creator-reference-build-configurations \title qmake Build Configuration - Specify build settings for the selected \l{glossary-buildandrun-kit} - {build and run kit} in \uicontrol Projects > \uicontrol {Build & Run} + \brief Settings for building applications with qmake. + + Specify build settings for the selected \l{glossary-buildandrun-kit}{kit} + in \uicontrol Projects > \uicontrol {Build & Run} > \uicontrol Build > \uicontrol {Build Settings}. \image qtcreator-projectpane.webp {qmake build settings} - By default, \QC builds qmake projects in a separate directory from the - source directory, as \l{glossary-shadow-build} {shadow builds}. This - keeps the files generated for each kit separate. If you only build and - run with a single kit, you can deselect the \uicontrol {Shadow build} - checkbox. + \section1 Build Directory + + By default, \QC builds qmake projects (that have .pro files) in a separate + directory from the source directory, as \l{glossary-shadow-build} + {shadow builds}. This keeps the files generated for each kit separate. If + you only build and run with a single kit, you can deselect the + \uicontrol {Shadow build} checkbox. Select the build directory in the \uicontrol {Build Directory} field. You can use the \l{Use Qt Creator variables}{variables} that are listed when @@ -30,6 +35,8 @@ \uicontrol {Default Build Properties}, and enter a period (.) in the \uicontrol {Default build directory} field. + \section1 Tooltips in Kit Selector + In the \uicontrol {Tooltip in target selector} field, you can enter text that is displayed as a tooltip when you hover the mouse over the build configuration in the \l{Building for Multiple Platforms}{kit selector}. @@ -39,37 +46,14 @@ {scopes} to select the file to process depending on which platform qmake is run on. + \section1 Separating Debug Info + If debug info is being generated, you can have it placed into separate files, rather than embedded into the binary, by selecting \uicontrol Enable in the \uicontrol {Separate debug info} field. For more information, see \l{Using the Performance Analyzer}. To use default settings, select \uicontrol {Leave at Default}. - In the \uicontrol {qmake system() behavior when parsing} field, you can - select whether processes are run via qmake's \c system() function or - ignored. Setting this option to \uicontrol Ignore might help if opening - or closing projects takes too long, but it might produce inexact parsing - results. - - \section1 Global qmake Settings - - To specify settings for all qmake builds, select \preferences > - \uicontrol {Build & Run} > \uicontrol Qmake. - - \image qtcreator-preferences-build-run-qmake.png "Qmake tab in Build & Run Preferences" - - To set the default build properties, select \preferences > - \uicontrol {Build & Run} > \uicontrol {Default Build Properties}. - - \image qtcreator-build-settings-default.webp {Default Build Properties tab in Build & Run Preferences} - - In the \uicontrol {Default build directory} field, you can use the variables - that are listed when you select \inlineimage icons/replace.png, as well as - variables that are available for a particular kit. Those you can see when - you select the button in the \uicontrol Projects > \uicontrol {Build & Run} > - \uicontrol Build > \uicontrol {Build Settings} > \uicontrol {Build Directory} - field for a kit. - \section1 Compiling QML You can compile QML source code into the final binary to improve the @@ -85,12 +69,39 @@ You can specify default behavior for compiling QML code in \preferences > \uicontrol {Build & Run} > \uicontrol Qmake > \uicontrol {Use qmlcachegen}. + \section1 Parsing Project Contents + + In the \uicontrol {qmake system() behavior when parsing} field, you can + select whether processes are run via qmake's \c system() function or + ignored. Setting this option to \uicontrol Ignore might help if opening + or closing projects takes too long, but it might produce inexact parsing + results. + + \section1 Global qmake Settings + + To specify settings for all qmake builds, select \preferences > + \uicontrol {Build & Run} > \uicontrol Qmake. + + \image qtcreator-preferences-build-run-qmake.png {Qmake tab in Build & Run Preferences} + + To set the default build properties, select \preferences > + \uicontrol {Build & Run} > \uicontrol {Default Build Properties}. + + \image qtcreator-build-settings-default.webp {Default Build Properties tab in Build & Run Preferences} + + In the \uicontrol {Default build directory} field, you can use the variables + that are listed when you select \inlineimage icons/replace.png, as well as + variables that are available for a particular kit. Those you can see when + you select the button in the \uicontrol Projects > \uicontrol {Build & Run} > + \uicontrol Build > \uicontrol {Build Settings} > \uicontrol {Build Directory} + field for a kit. + \section1 qmake Build Steps \QC builds qmake projects by running the \c make or \c nmake command from the Qt version defined for the current build configuration. - \image qtcreator-build-steps.png "Build steps" + \image qtcreator-build-steps.png {qmake build steps} To override the shell command that \QC constructs by default, disable or remove the build step and add a custom build step that specifies another @@ -111,4 +122,8 @@ Select \uicontrol {Add Build Step} > \uicontrol {Run Conan Install} to use the \l{Conan Build Configuration}{Conan} package manager with qmake + + \sa {Activate kits for a project}, {Configure projects for building}, + {Configure projects for running}, {Open projects} + */ diff --git a/doc/qtcreator/src/projects/creator-only/creator-how-to-select-build-systems.qdoc b/doc/qtcreator/src/projects/creator-only/creator-how-to-select-build-systems.qdoc index 38d0cb73d72..b8ed422cdfe 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-how-to-select-build-systems.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-how-to-select-build-systems.qdoc @@ -56,5 +56,6 @@ Specify build and run settings for different target platforms, in the \uicontrol Projects mode. - \sa {Specifying Build Settings}, {Build Systems}, {Use project wizards} + \sa {Configure projects for building}, {Configure projects for running}, + {Build Systems}, {Use project wizards} */ diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-building.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-building.qdoc index 6a5c085fd47..6071c329274 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-building.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-building.qdoc @@ -116,5 +116,6 @@ \image qtcreator-preferences-build-run-qmake.png "qmake tab in Build & Run Preferences" - For more information, see \l {qmake Build Configuration}. + \sa {Configure projects for building}, {Configure projects for running}, + {qmake Build Configuration} */ diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-opening.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-opening.qdoc index ccbe2316b47..7fe0105c1c5 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-opening.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-opening.qdoc @@ -95,7 +95,7 @@ of the \uicontrol {Configure Project} tab and select \uicontrol {Import}. You can edit the build configuration later. For more information, see - \l{Editing Build Configurations}. + \l{Edit build configurations}. \section1 Show progress information diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-build-qbs.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-build-qbs.qdoc index 71b13ce437f..57b193a1e20 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-build-qbs.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-build-qbs.qdoc @@ -2,12 +2,19 @@ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! - \previouspage creator-build-settings-qmake.html \page creator-build-settings-qbs.html - \nextpage creator-build-settings-meson.html + \previouspage creator-reference.html + + \ingroup creator-reference-build-configurations \title Qbs Build Configuration + \brief Settings for building applications with Qbs. + + Specify build settings for the selected \l{glossary-buildandrun-kit}{kit} in + \uicontrol Projects > \uicontrol {Build & Run} > \uicontrol Build > + \uicontrol {Build Settings}. + \image qtcreator-build-settings-qbs.png {Qbs build settings} Qbs builds projects in the directory specified in the diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-build.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-build.qdoc index 222c7e5d48f..ee32aee0806 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-build.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-build.qdoc @@ -1,4 +1,4 @@ -// Copyright (C) 2022 The Qt Company Ltd. +// Copyright (C) 2023 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only // ********************************************************************** @@ -8,41 +8,25 @@ // ********************************************************************** /*! - \previouspage creator-debuggers.html \page creator-build-settings.html - \nextpage creator-build-settings-cmake.html + \previouspage creator-how-tos.html - \title Specifying Build Settings + \ingroup creator-how-to-projects + \ingroup creator-how-to-build - Different build configurations allow you to quickly switch between - different build settings. By default, \QC creates \e debug, \e release, and - \e profile build configurations. A debug build has additional - debug symbols that you need for debugging the application but that you - can leave out from the release version. Generally, you use the debug - configuration for testing and the release configuration for creating - the final installation binary package. + \title Configure projects for building - If you selected CMake as the build system for the project, you can - use a \e {minimum size release} build configuration to create the - final installation binary package. It is a release build that makes the size - of the binary package as small as possible, even if this makes the - application slower. + Specify build settings for the selected \l{glossary-buildandrun-kit}{kit} in + \uicontrol Projects > \uicontrol {Build & Run} > \uicontrol Build > + \uicontrol {Build Settings}. - A profile build (which is called \e {release with debug information} - when using CMake) is an optimized release build that is delivered - with separate debug information. It is best suited for analyzing - applications. + \image qtcreator-build-configurations.png {Build Settings} - \section1 Managing Build Configurations + \section1 Manage build configurations - Specify build settings for the selected \l{glossary-buildandrun-kit} - {build and run kit} in \uicontrol Projects > \uicontrol {Build & Run} - > \uicontrol Build > \uicontrol {Build Settings}. - - \image qtcreator-build-configurations.png "Build Settings" - - To add a new build configuration, click \uicontrol Add and select the type of - configuration you would like to add. The options you have depend on the + To add a new build configuration to the list in + \uicontrol {Edit build configuration}, click \uicontrol Add and select the + type of configuration to add. The options you have depend on the build system that you selected for the project. You can add as many build configurations as you need. You can also select \uicontrol Clone to add a build configuration that is based on the currently selected one. @@ -50,9 +34,9 @@ Select \uicontrol Rename to give the currently selected build configuration a new name. - To delete the build configuration currently selected, click \uicontrol Remove. + To delete the currently selected build configuration, click \uicontrol Remove. - \section1 Editing Build Configurations + \section1 Edit build configurations Select the build configuration to edit in the \uicontrol {Edit build configuration} field. @@ -70,10 +54,7 @@ This topic describes the build settings at a general level. - For more information about debugging Qt Quick projects, see - \l{Setting Up QML Debugging}. - - \section1 Building on Remote Devices + \section1 Build on remote devices You can build applications on \l{Connecting Remote Linux Devices} {remote Linux} or \l{Adding Docker Devices}{Docker} devices if you @@ -86,7 +67,7 @@ Also, the \uicontrol {Open Terminal} button in the \uicontrol {Build Environment} section opens a terminal on the device. - \section1 Starting External Processes + \section1 Start external processes \QC executes external processes to accomplish tasks such as building and running applications. To execute the processes, \QC uses shell @@ -111,9 +92,10 @@ \uicontrol Executable field is always placed first when constructing the command. You can \l {Use Qt Creator variables}{use \QC variables} in arguments, - executable paths, and working directories. + executable paths, and working directories. That is, in all fields where you + see the \inlineimage icons/replace.png (\uicontrol {Variables}) button. - \section1 Build Steps + \section1 Add build steps \image qtcreator-cmake-build-steps.webp {CMake build steps} @@ -131,26 +113,35 @@ You can use \l{IncrediBuild Build Steps}{IncrediBuild} to accelerate the build process when using qmake or CMake. - \section2 Adding Custom Build Steps + To manage build steps: + + \list + \li To add a build step, select \uicontrol {Add Build Step} and select + the step to add. + \li To disable a step you added, select + \inlineimage icons/buildstepdisable.png (\uicontrol {Disable}). + \li To change the order of steps, select \inlineimage icons/arrowup.png + (\uicontrol {Move Up}) and \inlineimage icons/arrowdown.png + (\uicontrol {Move Down}). + \li To remove a step, select \inlineimage icons/close.png + (\uicontrol {Remove Item}). + \endlist + + \section2 Add custom build steps To add custom steps to the build settings, select \uicontrol {Add Build Step} > \uicontrol {Custom Process Step}. - By default, custom steps are enabled. To disable a custom step, select - the \inlineimage icons/buildstepdisable.png - (\uicontrol Disable) button. - \image qtcreator-build-steps-custom.png "Custom Process Step" + \image qtcreator-build-steps-custom.png {Custom Process Step} - \section2 Executing Custom Commands + \section2 Execute custom commands To execute custom commands when building for embedded devices, select \uicontrol {Add Build Step} > \uicontrol {Custom Remote Command (via adb shell)} (commercial only) and enter the command to execute. - \section1 Clean Steps - - \image qtcreator-clean-steps.png "Clean steps" + \section1 Add clean steps You can use the cleaning process to remove intermediate files. This process might help you to fix obscure issues during the process of building a @@ -165,19 +156,12 @@ \endlist You can define the clean steps for your builds in \uicontrol {Clean Steps}. + To add a clean step using make or a custom process, select + \uicontrol{Add Clean Step} and select the step to add. - \list + \image qtcreator-cmake-clean-steps.webp {Clean steps} - \li To add a clean step using make or a custom process, click - \uicontrol{Add Clean Step} and select the type of step you want to add. - - By default, custom steps are enabled. To disable a custom step, - select the \uicontrol Disable button. - - \li To remove a clean step, click \uicontrol{Remove Item}. - - \li To change the order of steps, click \inlineimage icons/arrowup.png - (\uicontrol {Move Up}) and \inlineimage icons/arrowdown.png - (\uicontrol {Move Down}). - \endlist + \sa {Configuring Projects}, {Select the build system}, {Use \QC variables}, + {Enable debugging}, {Setting Up QML Debugging}, + {Build Systems}{Reference: Build Systems} */ diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-environment.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-environment.qdoc index 504f9d02732..6a883e8666d 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-environment.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-environment.qdoc @@ -93,8 +93,8 @@ fetches information about the \uicontrol {Device Environment} from the device. Usually, it does not make sense to edit the device environment. - \sa {Batch edit environment settings}, {Specifying Build Settings}, - {Specifying Run Settings}, {Use Qt Creator variables} + \sa {Batch edit environment settings}, {Configure projects for building}, + {Configure projects for running}, {Use Qt Creator variables} */ /*! @@ -144,6 +144,6 @@ To temporarily disable a variable, add a hash character (#) to the beginning of the line. - \sa {Specify the environment for projects}, {Specifying Build Settings}, - {Use Qt Creator variables} + \sa {Specify the environment for projects}, {Configure projects for building}, + {Configure projects for running}, {Use Qt Creator variables} */ diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc index ab8a2f164ba..35c9b254894 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-overview.qdoc @@ -30,6 +30,49 @@ To specify build or run settings for a kit, select \uicontrol Build or \uicontrol Run below the kit name. + \section1 Specifying Build Settings + + \image qtcreator-build-configurations.png {Build configurations} + + Different build configurations allow you to quickly switch between + different build settings. By default, \QC creates the following + configurations: + + \list + \li Debug + \li Release + \li Profile + \endlist + + A debug build has debug symbols that you need for debugging the application + but that you can leave out from the release version. Generally, you use the + debug configuration for testing and the release configuration for creating + the final installation binary package. + + If you selected CMake as the build system for the project, you can + use a \e {minimum size release} build configuration to create the + final installation binary package. It is a release build that makes the size + of the binary package as small as possible, even if this makes the + application slower. + + A profile build (which is called \e {release with debug information} + when using CMake) is an optimized release build that is delivered + with separate debug information. It is best suited for analyzing + applications. + + \section1 Specifying Run Settings + + The run settings to specify depend on the type of the project and on the + \l{Kits}{Run device} that you select for the kit. + + \QC automatically creates deploy and run configurations for your project. + + \image qtcreator-settings-run-desktop.webp {Run Settings} + + To prevent \QC from automatically creating run configurations, select + \preferences > \uicontrol {Build & Run}, and then deselect the + \uicontrol {Create suitable run configurations automatically} check box. + \section1 Overriding Global Preferences In \uicontrol {Project Settings}, you can override global preferences for @@ -52,8 +95,8 @@ If you have multiple projects open in \QC, select the project to configure in \uicontrol {Active Project}. - \sa {Activate kits for a project}, {Open projects}, - {Specifying Build Settings}, {Specifying Run Settings} + \sa {Activate kits for a project}, {Configure projects for building}, + {Configure projects for running}, {Open projects} */ /*! diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-analyze.qdocinc b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-analyze.qdoc similarity index 58% rename from doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-analyze.qdocinc rename to doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-analyze.qdoc index e54035966d5..4f8188285f4 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-analyze.qdocinc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-analyze.qdoc @@ -1,17 +1,20 @@ -// Copyright (C) 2021 The Qt Company Ltd. +// Copyright (C) 2023 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! -//! [settings valgrind] + \page creator-run-settings-valgrind.html + \previouspage creator-how-tos.html - \section1 Specifying Valgrind Settings + \ingroup creator-how-to-analyze + + \title Specify Valgrind settings for a project + + Specify settings for running applications on the \l {Kits}{Run device} that + you select for a kit in \uicontrol Projects > \uicontrol {Build & Run} > + \uicontrol Run > \uicontrol {Run Settings}. \QC integrates \l{Analyzing Code}{Valgrind code analysis tools} for - detecting memory leaks and profiling function execution. You can configure - the tools according to your needs. - - You can specify Valgrind settings either globally for all projects or separately for each - project. + detecting memory leaks and profiling function execution. To specify Valgrind settings for the current project: @@ -21,7 +24,7 @@ \li Specify Valgrind settings for the project. - \image qtcreator-analyzer-settings.png "Valgrind Settings" + \image qtcreator-analyzer-settings.png {Valgrind Settings} \li In \uicontrol {Valgrind executable}, specify the path to the Valgrind executable. @@ -35,20 +38,11 @@ \endlist - For more information about the Callgrind and Memcheck settings, see: - - \list - - \li \l{Selecting Profiling Options} - - \li \l{Selecting Options for Memory Analysis} - - \endlist - Click \uicontrol {Restore Global} to revert to the global settings. To specify global Valgrind settings, select \preferences > \uicontrol Analyzer. -//! [settings valgrind] + \sa {Configuring Projects}, {Selecting Options for Memory Analysis}, + {Selecting Profiling Options}, {Using Valgrind Code Analysis Tools} */ diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-debug.qdocinc b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-debug.qdoc similarity index 73% rename from doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-debug.qdocinc rename to doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-debug.qdoc index 43277fbae18..99c0decce96 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-debug.qdocinc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-debug.qdoc @@ -2,11 +2,19 @@ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! -//! [run settings debugger] + \page creator-how-to-enble-debugging.html + \previouspage creator-how-tos.html - \section1 Enabling Debugging + \ingroup creator-how-to-projects + \ingroup creator-how-to-build - \image qtquick-debugger-settings.webp "Debugger Settings" + \title Enable debugging + + Specify settings for running applications on the \l {Kits}{Run device} that + you select for a kit in \uicontrol Projects > \uicontrol {Build & Run} > + \uicontrol Run > \uicontrol {Run Settings}. + + \image qtquick-debugger-settings.webp {Debugger Settings"} To select the languages to debug, select \uicontrol Automatic or \uicontrol Enabled in \uicontrol {Debugger Settings} > @@ -34,7 +42,5 @@ {enable QML debugging} either globally or in the \uicontrol {Build Settings} of the project. - For more information about debugging, see \l{Debugging}. - -//! [run settings debugger] + \sa {Configuring Projects}, {Debugging} */ diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-desktop.qdocinc b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-desktop.qdoc similarity index 73% rename from doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-desktop.qdocinc rename to doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-desktop.qdoc index 74e6357ee7b..02dc0de2a4b 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-desktop.qdocinc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run-desktop.qdoc @@ -1,10 +1,23 @@ -// Copyright (C) 2018 The Qt Company Ltd. +// Copyright (C) 2023 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! -//! [run settings desktop] + \page creator-run-settings-desktop-devices.html + \previouspage creator-reference.html - \section1 Specifying Run Settings for Desktop Device Types + \ingroup creator-reference-run-configurations + + \title Desktop Device Run Settings + + \brief Settings for running applications on desktop device types. + + Specify settings for running applications on the \l {Kits}{Run device} that + you select for a kit in \uicontrol Projects > \uicontrol {Build & Run} > + \uicontrol Run > \uicontrol {Run Settings}. + + \image qtcreator-settings-run-desktop.webp {Run Settings for desktop devices} + + \section1 Working Directory You can specify command-line arguments to be passed to the executable and the working directory to use. The working directory defaults to @@ -17,7 +30,7 @@ \uicontrol {Working directory} field as the installation directory in the \c {--install} signature. - \image qtcreator-settings-run-desktop.webp {Run Settings} + \section1 Run in Terminal For console applications, check the \uicontrol{Run in terminal} check box. To specify the terminal to use on Linux and \macos, select \preferences > @@ -25,9 +38,7 @@ {internal terminal}, select \preferences > \uicontrol Terminal > \uicontrol {Use internal terminal}. - To run with special environment variables set up, select them in the - \uicontrol {Run Environment} section. For more information, see - \l {Specify the run environment}. + \section1 Linker Libraries When building an application, \QC creates a list of directories where the linker will look for libraries that the application links to. By @@ -43,17 +54,18 @@ \uicontrol {Build & Run}, and then deselect the \uicontrol {Add linker library search paths to run environment} check box. + \section1 \macos Options + The \uicontrol {Use debug version of frameworks (DYLD_IMAGE_SUFFIX=_debug)} option (only available on \macos) enables you to debug (for example, step into) linked frameworks, such as the Qt framework itself. You do not need this option for debugging your application code. + \section1 Linux Options + On Linux, select the \uicontrol {Run as root user} check box to run the application with root user permissions. - You can also create custom executable run configurations where you - can set the executable to run. For more information, see - \l{Specifying a Custom Executable to Run}. - -//! [run settings desktop] + \sa {Configure projects for running}, {Specify a custom executable to run}, + {Specify the run environment} */ diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run.qdoc index 14205f59db2..461ef91fa1b 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-settings-run.qdoc @@ -1,4 +1,4 @@ -// Copyright (C) 2021 The Qt Company Ltd. +// Copyright (C) 2023 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only // ********************************************************************** @@ -8,27 +8,33 @@ // ********************************************************************** /*! - \previouspage creator-build-settings.html \page creator-run-settings.html - \nextpage creator-editor-settings.html + \previouspage creator-how-tos.html - \title Specifying Run Settings + \ingroup creator-how-to-projects + \ingroup creator-how-to-run - The run settings to specify depend on the type of the project and on the - \l{glossary-buildandrun-kit}{kit} that you build and run the project with. + \title Configure projects for running - \QC automatically creates run configurations for your project. - To view and modify them, select \uicontrol Projects > - \uicontrol {Build & Run} > \uicontrol Run. + Specify settings for running applications on the \l {Kits}{Run device} that + you select for a kit in \uicontrol Projects > \uicontrol {Build & Run} > + \uicontrol Run > \uicontrol {Run Settings}. - \image qtcreator-settings-run.webp {Run Settings} + \image qtcreator-settings-run-desktop.webp {Run Settings} - To prevent \QC from automatically creating run configurations, select - \preferences > \uicontrol {Build & Run}, - and then deselect the \uicontrol {Create suitable run configurations - automatically} check box. + The available build settings depend on the build system that you selected + for the project and the device type: - \section1 Managing Run Configurations + \list + \li \l {Android Run Settings}{Android} + \li \l {Boot2Qt Run Settings}{Boot2Qt} + \li \l {Desktop Device Run Settings}{Desktop} + \li \l {Python Run Settings}{Python} + \li \l {QNX Run Settings}{QNX} + \li \l {Remote Linux Run Settings}{Remote Linux} + \endlist + + \section1 Manage run configurations The available run configurations are listed in the \uicontrol {Run configuration} field. @@ -40,16 +46,18 @@ To remove the current run configuration, select \uicontrol Remove. + \section2 qmake run configurations + The run configurations for qmake projects derive their executable from the parsed .pro files. For more information on how the commands are constructed, - see \l{Starting External Processes}. + see \l{Start external processes}. - \section1 Selecting Default Run Target + \section1 Select the default run target If a project has multiple executables, you need to tell \QC which one it should run. - \section2 CMake Run Targets + \section2 CMake run targets When using CMake, you can filter the run target list by setting \c qtc_runnable as the value of the \c FOLDER property @@ -62,7 +70,7 @@ If you do not specify \c qtc_runnable for any project, \QC automatically adds run configurations for all targets specified in \c {CMakeLists.txt}. - \section2 qmake Run Targets + \section2 qmake run targets When using qmake, you can prevent \QC from automatically creating run configurations for subprojects by specifying the \c qtc_runnable @@ -82,32 +90,40 @@ For more information about qmake project templates, see \l {TEMPLATE}. - \section2 Meson Run Targets + \section2 Meson run targets \QC automatically adds run configurations for all targets declared with \c {executable()} function in Meson build descriptions. - \include creator-projects-settings-run-desktop.qdocinc run settings desktop - \include creator-projects-settings-run-analyze.qdocinc settings valgrind - \include creator-projects-settings-run-debug.qdocinc run settings debugger - \include creator-projects-settings-run-android.qdocinc run settings android - \include creator-projects-settings-run-linux.qdocinc run settings linux - \include creator-projects-settings-run-qnx.qdocinc run settings qnx - \include linux-mobile/creator-projects-settings-run-b2qt.qdocinc run settings boot2qt + \sa {Enable debugging}, {Configuring Projects}, + {Specify a custom executable to run}, + {Specify Valgrind settings for a project}, + {Run Configurations}{Reference: Run Configurations} +*/ - \section1 Specifying a Custom Executable to Run +/*! + \page creator-how-to-run-custom-executables.html + \previouspage creator-how-tos.html - If you use CMake, Meson or the generic project type in \QC, or want + \ingroup creator-how-to-run + + \title Specify a custom executable to run + + If you use \l{Setting Up Meson}{Meson} or the + \l{Setting Up a Generic Project}{generic project type}, or want to run a custom desktop executable, create a \uicontrol {Custom Executable} run configuration for your project. For example, when working on a library, you can run a test application that links against the library. - Specify the executable to run, command-line arguments, working directory, - and environment variables to use. + To specify a custom executable to run: - \image qmldesigner-run-custom-exe.png {Run settings for custom executables} - - \include qtquick/creator-projects-settings-run-qtquick.qdocinc run settings qt quick ui - \include python/creator-python-run.qdocinc run settings python + \list 1 + \li Select \uicontrol Add > \uicontrol {Custom Executable}. + \image qtcreator-run-settings-custom-executable.webp {Run settings for custom executables} + \li In \uicontrol Executable, specify the path to the executable. + \li In \uicontrol {Command line arguments}, enter the path to the + file to run. + \endlist + \sa {Configure projects for running} */ diff --git a/doc/qtcreator/src/projects/creator-only/qtcreator-how-to-use-qtc-variables.qdoc b/doc/qtcreator/src/projects/creator-only/qtcreator-how-to-use-qtc-variables.qdoc index cf8100a68ae..821cc7698ed 100644 --- a/doc/qtcreator/src/projects/creator-only/qtcreator-how-to-use-qtc-variables.qdoc +++ b/doc/qtcreator/src/projects/creator-only/qtcreator-how-to-use-qtc-variables.qdoc @@ -55,5 +55,6 @@ %{variable:-default} \endcode - \sa {Specify the environment for projects}, {Specifying Build Settings}, + \sa {Specify the environment for projects}, {Configure projects for building}, + {Configure projects for running} */ diff --git a/doc/qtcreator/src/projects/creator-projects-running.qdoc b/doc/qtcreator/src/projects/creator-projects-running.qdoc index 81756d4a408..9c833bf8e7e 100644 --- a/doc/qtcreator/src/projects/creator-projects-running.qdoc +++ b/doc/qtcreator/src/projects/creator-projects-running.qdoc @@ -66,15 +66,11 @@ \image qtcreator-application-output.webp {Application Output view} - \if defined(qtcreator) - For more information on the options you have, see - \l{Specifying Run Settings}. - \endif - \include linux-mobile/creator-projects-running-generic-linux.qdocinc running on embedded linux \if defined(qtcreator) + \include qnx/creator-projects-running-qnx.qdocinc running on qnx - \include python/creator-python-run.qdocinc running python + \sa {Configure projects for running}, {Run Python applications} \endif */ diff --git a/doc/qtcreator/src/python/creator-python-development.qdoc b/doc/qtcreator/src/python/creator-python-development.qdoc index 550172738ec..151abf2196b 100644 --- a/doc/qtcreator/src/python/creator-python-development.qdoc +++ b/doc/qtcreator/src/python/creator-python-development.qdoc @@ -23,8 +23,8 @@ \li \l{Create a virtual environment} \li \l{Use Python interactive shell} \li \l{Python Language Server} - \li \l{Running Python projects} - \li \l{Specifying Run Settings for Python Projects} + \li \l{Run Python applications} + \li \l{Python Run Settings} \li \l{PDB} \li \l{Launching the Debugger} \endlist diff --git a/doc/qtcreator/src/python/creator-python-run-settings.qdoc b/doc/qtcreator/src/python/creator-python-run-settings.qdoc new file mode 100644 index 00000000000..af47114c45c --- /dev/null +++ b/doc/qtcreator/src/python/creator-python-run-settings.qdoc @@ -0,0 +1,79 @@ +// Copyright (C) 2023 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \page creator-how-to-run-python-apps.html + \previouspage creator-how-tos.html + + \ingroup creator-how-to-projects + \ingroup creator-how-to-run + + \title Run Python applications + + You can execute Qt for Python applications directly from \QC. If you + use the new project wizard to create the application project, the + \c main.py file is automatically executed when you select the + \uicontrol Run button. + + You can specify another file to execute in the run settings of the project. + + \sa {Configure projects for running}, {Create Qt for Python applications}, + {Develop Qt for Python applications}, {Python Run Settings} +*/ + +/*! + \page creator-run-settings-python.html + \previouspage creator-reference.html + + \ingroup creator-reference-run-configurations + + \title Python Run Settings + + \brief Settings for running Qt for Python applications. + + Specify settings for running applications on the \l {Kits}{Run device} that + you select for a kit in \uicontrol Projects > \uicontrol {Build & Run} > + \uicontrol Run > \uicontrol {Run Settings}. + + \image qtcreator-python-run-settings.png {Python run settings} + + The following table summarizes the settings for running Qt for Python + applications. + + \table + \header + \li Setting + \li Value + \row + \li \uicontrol Interpreter + \li Path to the Python executable. + \row + \li \uicontrol {Buffered output} + \li Stores the output in a buffer. This improves output performance, + but causes delays in output. + \row + \li \uicontrol Script + \li Shows the path to the main file of the project that will be run. + \row + \li \uicontrol {Command line arguments} + \li Command-line arguments to pass to the executable. + \endtable + + \section1 Custom Executable Run Configuration + + To run some other Python file than \c main.py, create a custom + executable run configuration: + + \image qtcreator-python-run-settings-custom-executable.png {Python custom executable run configuration} + + \list 1 + \li Select \uicontrol Add > \uicontrol {Custom Executable}. + \li In the \uicontrol Executable field, specify the path to the + Python executable. + \li In the \uicontrol {Command line arguments} field, select + the Python file to run. + \endlist + + \sa {Activate kits for a project}, {Configure projects for running}, + {Create Qt for Python applications}, {Develop Qt for Python applications} +*/ diff --git a/doc/qtcreator/src/python/creator-python-run.qdocinc b/doc/qtcreator/src/python/creator-python-run.qdocinc deleted file mode 100644 index 445b32a577b..00000000000 --- a/doc/qtcreator/src/python/creator-python-run.qdocinc +++ /dev/null @@ -1,54 +0,0 @@ -// Copyright (C) 2020 The Qt Company Ltd. -// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only - -/*! -//! [running python] - \section1 Running Python Projects - - You can execute Qt for Python applications directly from \QC. If you - used the \l{Use project wizards}{new project wizard} - to create the application project, the \c main.py file is automatically - executed when you select the \uicontrol Run button. - - You can specify another file to execute in the - \l{Specifying Run Settings for Python Projects}{run settings} - of the project. - -//! [running python] - - -//! [run settings python] - - \section1 Specifying Run Settings for Python Projects - - You can specify settings for running Qt for Python applications: - - \image qtcreator-python-run-settings.png {Python run settings} - - \list - \li In the \uicontrol Interpreter field, specify the path to the - Python executable. - \li Select the \uicontrol {Buffered output} check box to buffer the - output. This improves output performance, but causes delays in - output. - \li In the \uicontrol Script field, you can see the path to the - main file of the project that will be run. - \li In the \uicontrol {Command line arguments} field, specify - command-line arguments to be passed to the executable. - \endlist - - If you want to run some other Python file than \c main.py, create a custom - executable run configuration: - - \image qtcreator-python-run-settings-custom-executable.png - - \list 1 - \li Select \uicontrol Add > \uicontrol {Custom Executable}. - \li In the \uicontrol Executable field, specify the path to the - Python executable. - \li In the \uicontrol {Command line arguments} field, select - the Python file to run. - \endlist - -//! [run settings python] -*/ diff --git a/doc/qtcreator/src/qnx/creator-projects-settings-run-qnx.qdoc b/doc/qtcreator/src/qnx/creator-projects-settings-run-qnx.qdoc new file mode 100644 index 00000000000..568eca91e37 --- /dev/null +++ b/doc/qtcreator/src/qnx/creator-projects-settings-run-qnx.qdoc @@ -0,0 +1,27 @@ +// Copyright (C) 2023 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \page creator-run-settings-qnx.html + \previouspage creator-reference.html + + \ingroup creator-reference-run-configurations + + \title QNX Run Settings + + \brief Settings for running applications on Linux-based devices. + + Specify settings for running applications on the \l {Kits}{Run device} that + you select for a kit in \uicontrol Projects > \uicontrol {Build & Run} > + \uicontrol Run > \uicontrol {Run Settings}. + + To run and debug an application on a QNX device, you must + create connections from the development PC to the device. Select + \uicontrol {Manage device configurations} to create a connection. + + Settings for QNX Neutrino devices are very similar to those for remote linux + devices. + + \sa {Remote Linux Run Settings}, {Activate kits for a project}, + {Configure projects for running}, {Kits}, {Connecting QNX Devices} +*/ diff --git a/doc/qtcreator/src/qnx/creator-projects-settings-run-qnx.qdocinc b/doc/qtcreator/src/qnx/creator-projects-settings-run-qnx.qdocinc deleted file mode 100644 index 0a8407c283f..00000000000 --- a/doc/qtcreator/src/qnx/creator-projects-settings-run-qnx.qdocinc +++ /dev/null @@ -1,18 +0,0 @@ -// Copyright (C) 2017 The Qt Company Ltd. -// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only - -/*! -//! [run settings qnx] - - \section1 Specifying Run Settings for QNX Devices - - To run and debug an application on a QNX device, you must - create connections from the development PC to the device. Click - \uicontrol {Manage device configurations} to create a connection. For more - information, see \l{Connecting QNX Devices}. - - Specifying run settings for QNX Neutrino devices is very similar to - \l{Specifying Run Settings for Linux-Based Devices}. - -//! [run settings qnx] -*/ diff --git a/doc/qtcreator/src/qtcreator-toc.qdoc b/doc/qtcreator/src/qtcreator-toc.qdoc index 2973f0d4847..55dbcb65226 100644 --- a/doc/qtcreator/src/qtcreator-toc.qdoc +++ b/doc/qtcreator/src/qtcreator-toc.qdoc @@ -26,19 +26,6 @@ \li \l{Creating Projects} \li \l{Configuring Projects} \list - \li \l{Specifying Build Settings} - \list - \li \l{Cmake Build Configuration} - \list - \li \l{CMake Presets} - \endlist - \li \l{qmake Build Configuration} - \li \l{Qbs Build Configuration} - \li \l{Meson Build Configuration} - \li \l{IncrediBuild Build Configuration} - \li \l{Conan Build Configuration} - \endlist - \li \l{Specifying Run Settings} \li \l{Using Custom Output Parsers} \li \l{Sharing Project Settings} \endlist @@ -182,6 +169,8 @@ \generatelist creator-how-to-build-with-cmake \li Build with qmake \generatelist creator-how-to-build-with-qmake + \li Run applications + \generatelist creator-how-to-run \li Debug \generatelist creator-how-to-debug \li Design UIs @@ -212,6 +201,13 @@ \list \li Build Systems \generatelist creator-reference-build-systems + \list + \li Build Configurations + \generatelist creator-reference-build-configurations + \li Run Configurations + \generatelist creator-reference-run-configurations + \endlist + \endlist \li Preferences \generatelist creator-reference-preferences \list @@ -229,6 +225,5 @@ \li Sidebar Views \generatelist creator-reference-sidebar-views \endlist - \endlist \endlist */ diff --git a/doc/qtcreator/src/qtquick/creator-projects-settings-run-qtquick.qdoc b/doc/qtcreator/src/qtquick/creator-projects-settings-run-qtquick.qdoc new file mode 100644 index 00000000000..52538411be9 --- /dev/null +++ b/doc/qtcreator/src/qtquick/creator-projects-settings-run-qtquick.qdoc @@ -0,0 +1,46 @@ +// Copyright (C) 2023 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \page creator-run-settings-qtquick-ui-prototype.html + \previouspage creator-reference.html + + \ingroup creator-reference-run-configurations + + \title Qt Quick UI Prototype Run Settings + + \brief Settings for running Qt Quick UI Prototype projects (.qmlproject). + + Specify settings for running applications on the \l {Kits}{Run device} that + you select for a kit in \uicontrol Projects > \uicontrol {Build & Run} > + \uicontrol Run > \uicontrol {Run Settings}. + + \note Select the \uicontrol Desktop device type for the \l{Kits}{Run device} + in the kit. + + \image qtquick-ui-prototype-run-settings.webp {Run Settings for a Qt Quick UI Prototype project} + + The following table summarizes the settings for running Qt Quick UI Prototype + projects (.qmlproject). + + \table + \header + \li Setting + \li Value + \row + \li \uicontrol {Override device QML Viewer} + \li \QQV to use. + \row + \li \uicontrol {Command line arguments} + \li Arguments to pass to the executable. + \row + \li \uicontrol {Main QML file} + \li File to start \QQV with. + \row + \li \uicontrol {Forward to local display} + \li Shows a remotely running X11 client on a local display. + \endtable + + \sa {Qt Quick UI Projects}, {Activate kits for a project}, + {Configure projects for running}, {Kits} +*/ diff --git a/doc/qtcreator/src/qtquick/creator-projects-settings-run-qtquick.qdocinc b/doc/qtcreator/src/qtquick/creator-projects-settings-run-qtquick.qdocinc deleted file mode 100644 index 1781b442494..00000000000 --- a/doc/qtcreator/src/qtquick/creator-projects-settings-run-qtquick.qdocinc +++ /dev/null @@ -1,27 +0,0 @@ -// Copyright (C) 2020 The Qt Company Ltd. -// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only - -/*! -//! [run settings qt quick ui] - - \section1 Specifying Run Settings for Qt Quick UI Projects - - You can specify run settings for \l{glossary-buildandrun-kit}{kits} - with \uicontrol Desktop device type: - - \list - - \li In the \uicontrol {QML Viewer} field, specify the \QQV to use. - - \li In the \uicontrol {Command line arguments} field, specify arguments - to be passed to the executable. - - \li In the \uicontrol {Main QML file}, select the file that \QQV will be - started with. - - \endlist - - \image qmldesigner-run-settings.png "Run settings for Qt Quick UI projects" - -//! [run settings qt quick ui] -*/ diff --git a/doc/qtcreator/src/user-interface/creator-only/creator-how-to-switch-between-modes.qdoc b/doc/qtcreator/src/user-interface/creator-only/creator-how-to-switch-between-modes.qdoc index a9c4e26dcbc..834b505f00c 100644 --- a/doc/qtcreator/src/user-interface/creator-only/creator-how-to-switch-between-modes.qdoc +++ b/doc/qtcreator/src/user-interface/creator-only/creator-how-to-switch-between-modes.qdoc @@ -55,7 +55,7 @@ \li \key Ctrl+5 \li Configure how to build and run projects. This mode is available when a project is open. - \li \l{Specifying Build Settings} + \li \l{Configuring Projects} \row \li \uicontrol Help \li \key Ctrl+6 diff --git a/doc/qtcreator/src/user-interface/creator-reference-output-views.qdoc b/doc/qtcreator/src/user-interface/creator-reference-output-views.qdoc index 523906cbc75..6ab04c25caf 100644 --- a/doc/qtcreator/src/user-interface/creator-reference-output-views.qdoc +++ b/doc/qtcreator/src/user-interface/creator-reference-output-views.qdoc @@ -121,8 +121,7 @@ \if defined(qtcreator) If you specify command-line arguments in the run settings that are passed to the application when running it, they are displayed as a part of the - application output. For more information, see - \l{Specifying Run Settings for Desktop Device Types}. + application output. For more information, see \l{Desktop Device Run Settings}. \endif Select toolbar buttons to run applications, to attach the debugger to the