Commit 328d205b authored by Eike Ziller's avatar Eike Ziller
Browse files

Device type + tool chain + other settings -> Kit



We called that "Target" before

Change-Id: Ie0d673c643947c26ac2706907f6250fc1739388a
Reviewed-by: default avatarLeena Miettinen <riitta-leena.miettinen@nokia.com>
parent fb59a39a
......@@ -107,7 +107,7 @@
\if defined(qcmanual)
\o On Windows, you must create projects for Maemo 5 and Harmattan
targets on the same partition where you installed \QSDK, \QC, and
device types on the same partition where you installed \QSDK, \QC, and
MADDE.
\endif
......
......@@ -32,7 +32,8 @@
\title Connecting Mobile Targets
You can connect mobile devices to the development PC to build, run, debug,
and analyze applications on them from \QC. When you install mobile targets
and analyze applications on them from \QC. When you install
\l{glossary-buildandrun-kit}{kits} for building and running on mobile targets
as part of the \QSDK, the build and run settings for the target devices are
set up automatically in \QC. However, \QSDK does not contain a tool chain
for building applications for embedded Linux devices.
......
......@@ -87,9 +87,10 @@
and commands used to build the project.
\QC provides support for building, running, and deploying Qt
applications for desktop environment and mobile devices. Build,
applications for desktop environment and mobile devices.
\l{glossary-buildandrun-kit}{Kits}, build,
run, and deployment settings allow you to quickly switch between
targets.
different setups and targets.
For more information, see \l{Building and Running}.
\o \bold {\l{Debugging and Analyzing}}
......
......@@ -50,22 +50,22 @@
\o Select \gui Projects to configure the project:
\image qtcreator-gs-build-example-targets.png "Selecting targets"
\image qtcreator-gs-build-example-targets.png "Selecting kit for building and running"
\list 1
\o Select at least \QS and one of the mobile
\l{glossary-development-target}{targets} (1), Maemo 5 or
\l{glossary-buildandrun-kit}{kits} (1), Maemo 5 or
MeeGo Harmattan, depending on the device you develop for.
\o Select \gui {Configure Project} (2).
\endlist
\o To test the application in \QS, click the \gui {Target
\o To test the application in \QS, click the \gui {Kit
Selector} and select \gui {\QS}.
\image qtcreator-gs-build-example-select-qs.png "Selecting Qt Simulator as target"
\image qtcreator-gs-build-example-select-qs.png "Selecting Qt Simulator as target device type"
\o Click
\inlineimage qtcreator-run.png
......
......@@ -34,20 +34,24 @@
\image creator_buildingrunning.png
\QC provides support for building, running, and deploying Qt applications
for different \l{glossary-development-target}{targets}.
for different targets, or using different compilers, debuggers or Qt versions.
\l{glossary-buildandrun-kit}{Kits} define the tools,
device type and other settings to use when building and running your project.
\list
\o \l{Building for Multiple Targets}
\e {Build configurations} contain everything you need to compile
the sources into binaries.
the sources into binaries. Build configurations use the tools and settings
defined in their corresponding \l{glossary-buildandrun-kit}{kit}.
\o \l{Running on Multiple Targets}
\e {Run configurations} start the application in the location
where it was copied by the \e{deploy configuration}. By default,
when you select the \gui Run function, \QC builds the project,
deploys it to the selected target, and runs it there. However,
deploys it to the target defined in the \l{glossary-buildandrun-kit}{kit},
and runs it there. However,
if you have not made any changes to the project since you last
built and deployed it, \QC simply runs it again.
......@@ -60,8 +64,8 @@
\o \l{Connecting Mobile Targets}
When you install tool chains for build targets as part of the \QSDK,
the build and run settings for mobile device targets are set up
When you install tool chains for device types as part of the \QSDK,
the build and run settings for mobile device types are set up
automatically. However, you might need to install and configure some
additional software on the devices to be able to connect to them
from the development PC.
......@@ -75,7 +79,7 @@
\o \l{Customizing the Build Process}
By default, running an application also builds it and deploys it to
a location from where it can be run on the target. You can change
a location from where it can be run on the target device. You can change
the relationship between the build, run, and deploy configurations.
\o \l{http://doc.qt.nokia.com/qtsimulator/index.html}
......@@ -89,7 +93,9 @@
Therefore, applications that run well on \QS also run on
any device that hosts the Qt and Qt Mobility libraries.
The \QS is installed as part of the \QSDK. After it is
installed, you can select it as a build target in \QC.
installed, you can create a \l{glossary-buildandrun-kit}{kit}
with \gui Desktop device type and the Qt Simulator Qt version for
building and running your projects.
\o \l{Using Maemo or MeeGo Harmattan Emulator}
......
......@@ -31,12 +31,15 @@
\title Building for Multiple Targets
You can build applications for multiple \l{glossary-development-target}
{targets}. By default, when you run the application on a target, you
automatically build it for the target and deploy it to the target first.
You can build applications for multiple targets, or using different compilers,
debuggers or Qt versions. \l{glossary-buildandrun-kit}{Kits} define the tools,
device type and other settings to use.
By default, when you run the application, you
automatically build and deploy it first.
However, you can also perform each operation separately.
To check that the application code can be compiled and linked for a target,
To check that the application code can be compiled and linked for a device,
you can build the project. The build errors and warnings are displayed in
the \gui {Issues} output pane. More detailed information is displayed
in the \gui {Compile Output} pane.
......@@ -45,9 +48,9 @@
\list 1
\o Select a target for the project.
\o Select a \l{glossary-buildandrun-kit}{kit} for the project.
\image qtcreator-target-selector.png "Target selector"
\image qtcreator-kit-selector.png "Kit selector"
\o Choose \gui {Build > Build Project} or press \key {Ctrl+B}.
......
......@@ -33,9 +33,9 @@
Qt is supported on a variety of 32-bit and 64-bit platforms, and can
usually be built on each platform with GCC, a vendor-supplied compiler, or
a third party compiler. In \QC, a \l{glossary-development-target}{target}
specifies the compiler and other necessary tools for building an
application for a particular platform.
a third party compiler. In \QC, a \l{glossary-buildandrun-kit}{kit}
specifies the compiler and other necessary tools for building and running an
application on a particular platform.
\QC automatically detects the compilers that are registered by your system
or by an SDK. You can add compilers to build applications by using other
......@@ -64,8 +64,8 @@
the application binary interface (ABI) version from the list of available
versions. You can also create a custom ABI definition.
You specify the compiler to use for each target in \gui Tools >
\gui Options > \gui {Build & Run} > \gui Targets.
You specify the compiler to use for each kit in \gui Tools >
\gui Options > \gui {Build & Run} > \gui Kits.
To add compilers:
......
......@@ -68,9 +68,9 @@
use \QC as a code editor and to fully control the steps and commands used to
build the project.
You can install mobile device \l{glossary-development-target}{targets}
as part of the \QSDK. The build and run settings for the
installed targets are set up automatically. However, you might need to
You can install tools for mobile devices
as part of the \QSDK. The \l{glossary-buildandrun-kit}{kits} and build and run settings for the
installed device types are set up automatically. However, you might need to
install and configure some additional software on the devices to be able to
connect to them from the development PC.
......@@ -78,7 +78,7 @@
In the first step, you
select a template for the project. You can filter templates (1) to view only
those that apply to a particular target.
those that apply to a particular device type.
\image qtcreator-new-qt-quick-project-wizard.png
......@@ -225,8 +225,8 @@
To create a new project, select \gui File > \gui{New File or Project} and
select the type of your project. The contents of the wizard dialogs depend
on the project type and the build targets that you select in the
\gui {Target Setup} dialog. Follow the instructions of the wizard.
on the project type and the \l{glossary-buildandrun-kit}{kits} that you select in the
\gui {Kit Selection} dialog. Follow the instructions of the wizard.
For examples of creating different types of projects, see
\l{Tutorials}.
......@@ -238,8 +238,8 @@
for building and running projects, select \gui{Tools} > \gui{Options} >
\gui{Build & Run} > \gui{General}.
To specify build and run settings for different target platforms, select
\gui Projects.
To specify build and run settings for different target platforms ,
select \gui Projects.
\section1 Adding Files to Projects
......
......@@ -39,19 +39,20 @@
one environment to another. Therefore, we recommend that you click \gui No
and enter the information again in the \gui {Configure Project} tab.
The \gui {Configure Project} tab displays a list of development environments
for target platforms that are installed on the development PC and
configured in \gui Tools > \gui Options > \gui {Build & Run} > \gui Targets.
Select the targets that you want to build the project for.
The \gui {Configure Project} tab displays a list of \l{glossary-buildandrun-kit}{kits}
for building and running projects, that are installed on the development PC and
configured in \gui Tools > \gui Options > \gui {Build & Run} > \gui Kits.
Select the kits that you want to build and run the project with.
\image qtcreator-open-project-targets.png "Configure Project tab"
Even if you do not intend to build the project, the C++ and QML code models
need a Qt version and compiler to offer code completion. To specify them,
select the \gui Options link, or select \gui {Tools > Options > Build & Run
> Targets}.
> Kits}.
If \QC cannot find an existing build for a particular target, it starts out
If \QC cannot find an existing build for a particular \l{glossary-buildandrun-kit}{kit},
it starts out
from a clean slate, and creates new debug and release build configurations
in the specified directory. \QC suggests a name
and location for the directory that you can change.
......@@ -71,7 +72,7 @@
\o Select \gui File > \gui{Open File or Project} and select the project
to open.
\o In the \gui {Configure Project} tab, select build targets for your
\o In the \gui {Configure Project} tab, select kits for building and running your
project, and click \gui {Configure Project}.
\endlist
......
......@@ -32,7 +32,7 @@
\title Adding Qt Versions
\QC allows you to have multiple versions of Qt installed on your development
PC and use different versions to build your projects for different targets.
PC and use different versions to build your projects.
For example, \QSDK contains special Qt versions for developing applications
for mobile devices.
......@@ -42,8 +42,9 @@
\gui {Qt version for} section. To add Qt versions, select
\gui {Tools > Options > Build & Run > Qt Versions}.
You specify the Qt version to use for each \l{glossary-development-target}
{target} in \gui Tools > \gui Options > \gui {Build & Run} > \gui Targets.
You specify the Qt version to use for each \l{glossary-buildandrun-kit}
{kit} for building and running your projects
in \gui Tools > \gui Options > \gui {Build & Run} > \gui Kits.
\section2 Setting Up New Qt Versions
......
......@@ -2,9 +2,9 @@
\list 1
\o Select \gui Desktop as the target.
\o Select \gui Desktop as the build and run \l{glossary-buildandrun-kit}{kit}.
\image qtcreator-target-selector.png "Target selector"
\image qtcreator-kit-selector.png "Kit selector"
\o Click the \gui Run button.
......
......@@ -7,7 +7,7 @@
\list 1
\o Select \gui {\QS} as the target.
\o Select \gui {\QS} as the build and run \l{glossary-buildandrun-kit}{kit}.
\o Click the \gui Run button.
......
......@@ -55,11 +55,12 @@
By default, \QC builds projects in a separate directory from the source
directory, as \l{glossary-shadow-build} {shadow builds}. This keeps the
files generated for each \l{glossary-development-target}{target} separate.
If you only build for one target, you can deselect the \gui {Shadow build}
files generated for each \l{glossary-buildandrun-kit}{build and run kit} separate.
If you only build and run with a single \l{glossary-buildandrun-kit}{kit},
you can deselect the \gui {Shadow build}
checkbox.
Shadow building is not supported for the following target platforms on
Shadow building is not supported for the following device types on
Windows:
\list
......@@ -192,7 +193,7 @@
\list
\o \l{Adding Targets}
\o \l{Adding Kits}
\o \l{Adding Qt Versions}
\o \l{Adding Compilers}
......
......@@ -33,8 +33,7 @@
\omit
When you install the \QSDK, the build and run settings for the development
targets
delivered with the \QSDK are set up automatically.
targets delivered with the \QSDK are set up automatically.
\endomit
To view and modify the settings for currently open projects, switch to the
......@@ -42,23 +41,23 @@
\image qtcreator-project-targets.png
To add build and run targets for the project, select \gui Add. The list
displays targets that are configured in \gui Tools > \gui Options >
\gui {Build & Run} > \gui Targets. To add targets to the list, select
To add build and run \l{glossary-buildandrun-kit}{kits} for the project, select \gui Add. The list
displays kits that are configured in \gui Tools > \gui Options >
\gui {Build & Run} > \gui Kits. To add kits to the list, select
\gui Manage.
To remove a target, hover the cursor over it (1) and click
\inlineimage qtcreator-target-remove.png "Remove Target button"
To remove a kit, hover the cursor over it (1) and click
\inlineimage qtcreator-target-remove.png "Remove Kit button"
.
You can select the targets and use the \gui Build menu commands to build,
You can select the kits and use the \gui Build menu commands to build,
deploy, and run projects.
The project pane consists of the following tabs:
\list
\o \l{Adding Targets}{Targets}
\o \l{Adding Kits}{Build & Run}
\list
......@@ -69,7 +68,7 @@
\endlist
\note If you have not configured the project for building, the
\gui Targets tab is replaced by the \l{Opening Projects}
\gui {Build & Run} tab is replaced by the \l{Opening Projects}
{Configure Projects} tab.
\o \l{Specifying Editor Settings}{Editor Settings}
......
......@@ -4,8 +4,7 @@
detecting memory leaks and profiling function execution. You can configure
the tools according to your needs.
You can specify analyzer settings for the desktop and \QS targets.
You can specify them either globally for all projects or separately for each
You can specify analyzer settings either globally for all projects or separately for each
project.
To specify analyzer settings for the current project:
......
\section2 Specifying Run Settings for Desktop Targets
\section2 Specifying Run Settings for Desktop Device Types
You can specify command line arguments to be passed to the executable
and the working directory to use. The working directory defaults to
......
......@@ -32,10 +32,10 @@
\title Specifying Run Settings
\QC automatically creates run configurations for your project.
To view and modify the settings, select \gui {Projects > Run}.
To view and modify the settings, select \gui {Projects > Build & Run > Run}.
The settings to specify depend on the type of the project and on the build
target for the project.
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.
Click \gui Add to add run settings for a project and \gui Remove to remove
the current settings.
......
......@@ -29,13 +29,14 @@
\page creator-targets.html
\nextpage creator-project-qmake.html
\title Adding Targets
\title Adding Kits
\QC groups platform specific settings as \e targets to make cross-platform
development easier. Each target consists of a set of values that define one
\QC groups settings used for building and running projects as kits
to make cross-platform and cross-configuration
development easier. Each kit consists of a set of values that define one
environment, such as a device, compiler, Qt version, and debugger command
to use, and some metadata, such as an icon and a name for the target. Once
you have defined targets, you can select them to build and run projects.
to use, and some metadata, such as an icon and a name for the kit. Once
you have defined kits, you can select them to build and run projects.
\QC supports development for the desktop and for the following types of
devices:
......@@ -54,18 +55,18 @@
\endlist
To add targets:
To add kits:
\list 1
\o Select \gui Tools > \gui Options > \gui {Build & Run} > \gui Targets
\o Select \gui Tools > \gui Options > \gui {Build & Run} > \gui Kits
> \gui Add.
\image qtcreator-targets.png
To clone the selected target, select \gui Clone.
To clone the selected kit, select \gui Clone.
\o In the \gui Name column, double-click the target name to change it.
\o In the \gui Name column, double-click the kit name to change it.
......@@ -73,11 +74,11 @@
target.
Double-click the icon next to the field to select the image that is
displayed in the target selector for this target. You can use any
displayed in the kit selector for this kit. You can use any
image in a supported file format (for example, PNG). The image is
scaled to the size 64x64 pixels. For example, using the compiler
logo as an icon allows you to easily see, which compiler is used to
build the project for the selected target.
build the project for the selected kit.
\o In the \gui Device field, select the device configuration to target.
......@@ -104,7 +105,7 @@
\QC checks the directories listed in the \c{PATH} environment
variable for the qmake executable. If a qmake executable is found,
it is referred to as \bold{Qt in PATH} and selected as the Qt
version to use for the \gui Desktop target.
version to use for the \gui Desktop kit that is created by default.
\o In the \gui {Qt mkspec} field, specify build instructions for qmake.
If you leave this field empty, the default value is used.
......
......@@ -169,7 +169,7 @@
\list
\o \l{Specifying Build Settings}
\list
\o \l{Adding Targets}
\o \l{Adding Kits}
\o \l{Adding Qt Versions}
\o \l{Adding Compilers}
\endlist
......
\section1 Specifying Run Settings for Qt Quick UI Projects
You can specify run settings for the \gui Desktop target:
You can specify run settings for \l{glossary-buildandrun-kit}{kits} with \gui Desktop device type:
\list
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment