feedc0de/qt-creator
1
0
Fork 0
forked from qt-creator/qt-creator
Code Pull Requests Activity

Doc: Describe setting build and run environment for a kit

Browse Source 
Task-number: QTCREATORBUG-32016
Change-Id: I52b92db075e393b90393d8fce9c187835fa9ad68
Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>
This commit is contained in:
Leena Miettinen
2025-01-15 10:58:04 +01:00
parent e23e8e509e
commit 6f72adbb28
5 changed files with 19 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/qtcreator/images/qtcreator-kits.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 34 KiB

BIN
doc/qtcreator/images/qtcreator-preferences-kits.webp Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 19 KiB

2
doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc
View File

@@ -32,7 +32,7 @@
another kit. To specify the debugger and compiler to use for each kit, go to another kit. To specify the debugger and compiler to use for each kit, go to
\preferences > \uicontrol Kits. \preferences > \uicontrol Kits.
\image qtcreator-kits.png {Kits preferences} \image qtcreator-preferences-kits.webp {Kits preferences}
You need to set up the debugger only if the automatic setup fails because You need to set up the debugger only if the automatic setup fails because
the debugger is missing (for example, you must install the CDB the debugger is missing (for example, you must install the CDB

16
doc/qtcreator/src/projects/creator-only/creator-projects-kits.qdoc
View File

@@ -44,7 +44,7 @@
\li Select \preferences > \uicontrol Kits. \li Select \preferences > \uicontrol Kits.
\li Select \uicontrol Add to start from an empty kit or \uicontrol Clone \li Select \uicontrol Add to start from an empty kit or \uicontrol Clone
to clone the selected kit and edit its preferences. to clone the selected kit and edit its preferences.
\image qtcreator-kits.png \image qtcreator-preferences-kits.webp {Kits preferences}
\li Set \l{Kits}{kit preferences} according to the build system and \li Set \l{Kits}{kit preferences} according to the build system and
device type. device type.
@@ -80,7 +80,7 @@
\uicontrol Kits. For example, if you use CMake to build all your projects, \uicontrol Kits. For example, if you use CMake to build all your projects,
you can hide Qbs and qmake preferences by default. you can hide Qbs and qmake preferences by default.
\image qtcreator-kits.png \image qtcreator-preferences-kits.webp {Kits preferences}
\section1 Filtering Kit Preferences \section1 Filtering Kit Preferences
@@ -147,9 +147,15 @@
information from \uicontrol {Qt mkspec}, which you can change. information from \uicontrol {Qt mkspec}, which you can change.
\row \row
\li \uicontrol Environment \li \uicontrol Environment
\li Select \uicontrol Change to modify environment variable values for \li Select \uicontrol {Edit Build Environment} to modify
build environments in the \uicontrol {Edit Environment Changes} environment variable values for build environments in
dialog. For more information about how to add and remove variable the \uicontrol {Edit Build Environment} dialog.
Select \uicontrol {Edit Run Environment} to modify
environment variable values for run environments in
the \uicontrol {Edit Run Environment} dialog.
For more information about how to add and remove variable
values, see \l{Edit environment settings}. values, see \l{Edit environment settings}.
\row \row
\li \uicontrol {Force UTF-8 MSVC compiler output} \li \uicontrol {Force UTF-8 MSVC compiler output}

10
doc/qtcreator/src/projects/creator-only/creator-projects-settings-environment.qdoc
View File

@@ -22,7 +22,7 @@
The final environment is specified separately for each kit. With The final environment is specified separately for each kit. With
project-specific environment settings you can change the environment for project-specific environment settings you can change the environment for
all kits that you use to build, deploy, and run the project simultaneously, all kits that you use to build, deploy, and run the project simultaneously,
rather than having to change it separately for each kit. rather than having to change it separately for each \l{Kits}{kit}.
The changes are stored in the local project-specific \c{CMakeLists.txt.user} The changes are stored in the local project-specific \c{CMakeLists.txt.user}
or \c{.pro.user} file, depending on the build system you use, such as CMake or \c{.pro.user} file, depending on the build system you use, such as CMake
@@ -125,7 +125,7 @@
\title Edit environment settings \title Edit environment settings
You can change the environment variable values for build or run environments You can change the environment variable values for build or run environments
either for a particular project or globally: globally or for a particular project or kit:
\list \list
\li To change values globally, go to \preferences > \li To change values globally, go to \preferences >
@@ -135,6 +135,10 @@
\uicontrol {Add} in the \l {Change the environment for a project} \uicontrol {Add} in the \l {Change the environment for a project}
{project}, \l {Specify the build environment}{build}, or {project}, \l {Specify the build environment}{build}, or
\l {Specify the run environment}{run} environment settings. \l {Specify the run environment}{run} environment settings.
\li To change values for a kit, go to \preferences >
\uicontrol Kits > \uicontrol Kits, and select
\uicontrol {Edit Build Environment} or
\uicontrol {Edit Run Environment} in \uicontrol {Environment}.
\endlist \endlist
\image qtcreator-edit-environment.webp {Edit Environment dialog} \image qtcreator-edit-environment.webp {Edit Environment dialog}
@@ -168,5 +172,5 @@
characters (##). characters (##).
\sa {Specify the environment for projects}, {Configure projects for building}, \sa {Specify the environment for projects}, {Configure projects for building},
{Configure projects for running}, {Use Qt Creator variables} {Configure projects for running}, {Use Qt Creator variables}, {Kits}
*/ */