2011-09-27 11:55:44 +02:00
|
|
|
/****************************************************************************
|
|
|
|
|
**
|
2014-01-07 13:27:11 +01:00
|
|
|
** Copyright (c) 2014 Digia Plc and/or its subsidiary(-ies).
|
2012-10-02 09:12:39 +02:00
|
|
|
** Contact: http://www.qt-project.org/legal
|
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.
|
2012-09-03 17:50:37 +02:00
|
|
|
To view and modify the settings, select \gui {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
|
|
|
|
|
|
|
|
Click \gui Add to add run settings for a project and \gui Remove to remove
|
|
|
|
|
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}.
|
|
|
|
|
|
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
|
|
|
|
|
environment in the \gui {Run Environment} section.
|
|
|
|
|
|
|
|
|
|
You can edit existing environment variables or add, reset and unset new
|
|
|
|
|
variables.
|
|
|
|
|
|
|
|
|
|
\image qtcreator-run-environment.png "Run Environment section"
|
|
|
|
|
|
|
|
|
|
When running on the desktop, the \gui {Build Environment} is used by
|
|
|
|
|
default, but you can also use the \gui {System Environment} without the
|
|
|
|
|
additions made to the build environment. For more information, see
|
|
|
|
|
\l {Build Environment}.
|
|
|
|
|
|
|
|
|
|
To run in a clean system environment, select \gui {Clean Environment}.
|
|
|
|
|
|
|
|
|
|
When running on a mobile device connected to the development host, \QC
|
|
|
|
|
fetches information about the \gui {Device Environment} from the device.
|
|
|
|
|
Usually, it does not make sense to edit the device environment.
|
|
|
|
|
|
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
|
|
|
|
|
to run a custom desktop executable, create a \gui {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.
|
|
|
|
|
|
|
|
|
|
\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
|
|
|
*/
|
