2011-09-27 11:55:44 +02:00
|
|
|
/****************************************************************************
|
|
|
|
|
**
|
2015-01-14 18:07:15 +01:00
|
|
|
** Copyright (C) 2015 The Qt Company Ltd.
|
|
|
|
|
** Contact: http://www.qt.io/licensing
|
2011-09-27 11:55:44 +02:00
|
|
|
**
|
2012-10-02 09:12:39 +02:00
|
|
|
** This file is part of Qt Creator
|
2011-09-27 11:55:44 +02:00
|
|
|
**
|
|
|
|
|
**
|
|
|
|
|
** GNU Free Documentation License
|
|
|
|
|
**
|
|
|
|
|
** Alternatively, this file may be used under the terms of the GNU Free
|
|
|
|
|
** Documentation License version 1.3 as published by the Free Software
|
|
|
|
|
** Foundation and appearing in the file included in the packaging of this
|
|
|
|
|
** file.
|
|
|
|
|
**
|
|
|
|
|
**
|
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
|
|
// **********************************************************************
|
|
|
|
|
// NOTE: the sections are not ordered by their logical order to avoid
|
|
|
|
|
// reshuffling the file each time the index order changes (i.e., often).
|
|
|
|
|
// Run the fixnavi.pl script to adjust the links to the index order.
|
|
|
|
|
// **********************************************************************
|
|
|
|
|
|
|
|
|
|
/*!
|
2014-03-17 12:18:12 +01:00
|
|
|
\contentspage {Qt Creator Manual}
|
2013-04-18 11:41:31 +02:00
|
|
|
\previouspage creator-build-settings.html
|
2011-09-27 11:55:44 +02:00
|
|
|
\page creator-run-settings.html
|
|
|
|
|
\nextpage creator-editor-settings.html
|
|
|
|
|
|
|
|
|
|
\title Specifying Run Settings
|
|
|
|
|
|
|
|
|
|
\QC automatically creates run configurations for your project.
|
2014-12-11 15:43:19 +01:00
|
|
|
To view and modify the settings, select \uicontrol {Projects > Build & Run > Run}.
|
2011-09-27 11:55:44 +02:00
|
|
|
|
2012-09-03 17:50:37 +02:00
|
|
|
The 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.
|
2011-09-27 11:55:44 +02:00
|
|
|
|
2014-12-11 15:43:19 +01:00
|
|
|
Click \uicontrol Add to add run settings for a project and \uicontrol Remove to remove
|
2011-09-27 11:55:44 +02:00
|
|
|
the current settings.
|
|
|
|
|
|
|
|
|
|
\section1 Specifying Run Settings for qmake Projects
|
|
|
|
|
|
|
|
|
|
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}.
|
|
|
|
|
|
2014-08-13 17:22:07 +02:00
|
|
|
\section2 Creating Run Configurations for Subprojects
|
|
|
|
|
|
|
|
|
|
To prevent \QC from automatically creating run configurations for SUBDIRS
|
|
|
|
|
projects, specify the following variable in the .pro file of the SUBDIRS
|
|
|
|
|
project: \c {CONFIG += qtc_runnable}.
|
|
|
|
|
|
|
|
|
|
\QC creates run configurations only for subprojects that also have
|
|
|
|
|
\c {CONFIG += qtc_runnable} set in their .pro files.
|
|
|
|
|
|
2013-02-06 08:50:23 +01:00
|
|
|
\include projects/creator-projects-settings-run-desktop.qdocinc
|
|
|
|
|
\include projects/creator-projects-settings-run-analyze.qdocinc
|
|
|
|
|
\include projects/creator-projects-settings-run-debug.qdocinc
|
|
|
|
|
\include linux-mobile/creator-projects-settings-run-linux.qdocinc
|
|
|
|
|
\include qnx/creator-projects-settings-run-qnx.qdocinc
|
2011-09-27 11:55:44 +02:00
|
|
|
|
2013-05-27 12:32:29 +02:00
|
|
|
\section1 Selecting the Run Environment
|
|
|
|
|
|
|
|
|
|
\QC automatically selects the environment used for running the application
|
|
|
|
|
based on the device type. You can edit the environment or select another
|
2014-12-11 15:43:19 +01:00
|
|
|
environment in the \uicontrol {Run Environment} section.
|
2013-05-27 12:32:29 +02:00
|
|
|
|
|
|
|
|
You can edit existing environment variables or add, reset and unset new
|
|
|
|
|
variables.
|
|
|
|
|
|
|
|
|
|
\image qtcreator-run-environment.png "Run Environment section"
|
|
|
|
|
|
2014-12-11 15:43:19 +01:00
|
|
|
When running on the desktop, the \uicontrol {Build Environment} is used by
|
|
|
|
|
default, but you can also use the \uicontrol {System Environment} without the
|
2013-05-27 12:32:29 +02:00
|
|
|
additions made to the build environment. For more information, see
|
|
|
|
|
\l {Build Environment}.
|
|
|
|
|
|
2014-12-11 15:43:19 +01:00
|
|
|
To run in a clean system environment, select \uicontrol {Clean Environment}.
|
2013-05-27 12:32:29 +02:00
|
|
|
|
|
|
|
|
When running on a mobile device connected to the development host, \QC
|
2014-12-11 15:43:19 +01:00
|
|
|
fetches information about the \uicontrol {Device Environment} from the device.
|
2013-05-27 12:32:29 +02:00
|
|
|
Usually, it does not make sense to edit the device environment.
|
|
|
|
|
|
2014-11-25 12:42:26 +01:00
|
|
|
To modify the environment variable values for the run environment, select
|
2014-12-11 15:43:19 +01:00
|
|
|
\uicontrol {Batch Edit}. For more information, see \l{Batch Editing}.
|
2014-11-25 12:42:26 +01:00
|
|
|
|
2011-09-27 11:55:44 +02:00
|
|
|
\section1 Specifying a Custom Executable to Run
|
|
|
|
|
|
|
|
|
|
If you use CMake or the generic project type in \QC, or want
|
2014-12-11 15:43:19 +01:00
|
|
|
to run a custom desktop executable, create a \uicontrol {Custom Executable}
|
2011-09-27 11:55:44 +02:00
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
\image qmldesigner-run-custom-exe.png "Run settings for custom executables"
|
|
|
|
|
|
2013-02-06 08:50:23 +01:00
|
|
|
\include qtquick/creator-projects-settings-run-qtquick.qdocinc
|
2011-09-27 11:55:44 +02:00
|
|
|
*/
|
