creator-projects-building-running.qdoc 3.88 KB
Newer Older
1 2
/****************************************************************************
**
3 4
** Copyright (C) 2016 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
5
**
6
** This file is part of the Qt Creator documentation.
7
**
8 9 10 11 12 13 14
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
15
**
16
** GNU Free Documentation License Usage
17 18
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
19 20 21 22
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
23 24 25 26 27 28 29 30 31 32
**
****************************************************************************/

// **********************************************************************
// 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.
// **********************************************************************

/*!
33
    \contentspage {Qt Creator Manual}
34
    \previouspage creator-scxml.html
35 36 37
    \page creator-building-running.html
    \nextpage creator-building-targets.html

38 39 40
    \title Building and Running

    \image creator_buildingrunning.png
41

42
    \QC provides support for running and deploying Qt applications built
43 44
    for different target platforms, or using different compilers, debuggers, or
    Qt versions.
45 46
    \l{glossary-buildandrun-kit}{Kits} define the tools,
    device type and other settings to use when building and running your project.
47 48

    \list
49
        \li \l{Building for Multiple Platforms}
50 51

            \e {Build configurations} contain everything you need to compile
52
            the sources into binaries. Build configurations use the tools and settings
53
            defined in their corresponding kit.
54

55
        \li \l{Running on Multiple Platforms}
56

57 58
            \e {Run configurations} start the application in the location
            where it was copied by the \e{deploy configuration}. By default,
59
            when you select the \uicontrol Run function, \QC builds the project,
60
            deploys it to the device defined in the kit, and runs it there. However,
61 62
            if you have not made any changes to the project since you last
            built and deployed it, \QC simply runs it again.
63

64
        \li \l{Deploying to Mobile Devices}
65

66 67 68 69 70
            \e {Deploy configurations} handle the packaging and copying of
            the necessary files to a location you want to run the executable
            at. The files can be copied to a location in the file system of
            the development PC or a mobile device.

71
        \li \l{Connecting Mobile Devices}
72

73
            When you install tool chains for device types as part of a Qt distribution,
74
            the build and run settings for mobile device types might be set up
75 76 77
            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 79 80

    \endlist

81 82 83 84
    \section1 Related Topics

    \list

85
        \li \l{Customizing the Build Process}
86 87

            By default, running an application also builds it and deploys it to
88
            a location from where it can be run on the device. You can change
89 90 91
            the relationship between the build, run, and deploy configurations.

    \endlist
92 93

*/