aboutsummaryrefslogtreecommitdiffstats
path: root/doc/qtcreator/src/projects/creator-projects-running.qdoc
blob: a7d6a27f9aa61f451baf08daa3e5653dce314cb0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
/****************************************************************************
**
** Copyright (C) 2020 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt Creator documentation.
**
** 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.
**
** GNU Free Documentation License Usage
** 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. 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.
**
****************************************************************************/

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

/*!
    \page creator-running-targets.html
    \if defined(qtdesignstudio)
    \previouspage studio-live-preview.html
    \else
    \previouspage creator-building-targets.html
    \endif
    \nextpage creator-deployment.html

    \title Running on Multiple Platforms

    By default, running an application also builds it and deploys it to a
    location from where it can be run on the desktop, on a device emulator or
    simulator, or on a \l{glossary-device}{device} that is connected to
    the development PC.

    To run executable files without deploying them first, select \uicontrol Build >
    \uicontrol {Run Without Deployment}. To make this the default option, deselect the
    \uicontrol Tools > \uicontrol Options > \uicontrol {Build & Run} >
    \uicontrol General > \uicontrol {Always deploy project before running it}
    check box.

    To run applications:

    \list 1

        \li Click the \uicontrol {Build and Run Kit Selector} icon (1) or select
            \uicontrol Build > \uicontrol {Open Build and Run Kit Selector} to select the
            build and run \l{glossary-buildandrun-kit}{kit}.

            \image qtcreator-kit-selector.png "Kit selector"

        \li Click the \uicontrol Run button (2).

    \endlist

    The \uicontrol {Application Output} pane displays the status of the
    application while it is running. You can select the \uicontrol Run button
    in the pane to re-run applications without building them first. This is
    useful when developing Qt Quick applications, because the QML files are
    interpreted at runtime. Therefore, the application does not need to be
    built again if you edited only QML files. This saves time especially if
    the application contains large image files that would need to be bundled
    into the resource file before running the application.

    \image qtcreator-application-output.png

    \if defined(qtcreator)
    For more information on the options you have, see
    \l{Specifying Run Settings}.
    \endif

    \include linux-mobile/creator-projects-running-generic-linux.qdocinc running on embedded linux

    \if defined(qtcreator)
    \include qnx/creator-projects-running-qnx.qdocinc running on qnx
    \include python/creator-python-run.qdocinc running python
    \endif
*/