forked from qt-creator/qt-creator
Doc: Describe changes in enabling mixed C++/QML debugging
The check boxes are now combo boxes with several options. Task-number: QTCREATORBUG-28996 Change-Id: Ib3ba3abb5c307b4fecffd267084bb2bd4057add9 Reviewed-by: Eike Ziller <eike.ziller@qt.io>
This commit is contained in:
BIN
doc/qtcreator/images/qtquick-debugger-settings.webp
Normal file
BIN
doc/qtcreator/images/qtquick-debugger-settings.webp
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 3.4 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 2.5 KiB |
@@ -42,9 +42,11 @@
|
||||
\section2 Debugging Qt Quick UI Projects
|
||||
\endif
|
||||
|
||||
To debug Qt Quick UI projects (.qmlproject), select the
|
||||
\uicontrol {Enable QML} check box in \uicontrol {Debugger settings}
|
||||
in \uicontrol Projects mode \uicontrol {Run Settings}.
|
||||
To debug Qt Quick UI projects (.qmlproject), select \uicontrol Automatic
|
||||
or \uicontrol Enabled in \uicontrol{Run Settings} >
|
||||
\uicontrol {Debugger Settings} > \uicontrol {QML debugger}.
|
||||
|
||||
\image qtquick-debugger-settings.webp {Debugger settings section in Run Settings}
|
||||
|
||||
\if defined(qtcreator)
|
||||
\section2 Debugging Qt Quick Applications
|
||||
@@ -65,9 +67,13 @@
|
||||
functions. Therefore, you must make sure that the port is properly
|
||||
protected by a firewall.
|
||||
|
||||
\li In \uicontrol {Run Settings} > \uicontrol {Debugger settings}, select
|
||||
the \uicontrol {Enable QML} check box to enable QML debugging for
|
||||
running applications.
|
||||
\li In \uicontrol {Run Settings} > \uicontrol {Debugger settings} >
|
||||
\uicontrol {QML debugger}, select \uicontrol Automatic or
|
||||
\uicontrol Enabled to enable QML debugging for running applications.
|
||||
|
||||
To debug both the C++ and QML parts of your application at the same
|
||||
time, also select \uicontrol Automatic or \uicontrol Enabled in
|
||||
\uicontrol {C++ debugger}.
|
||||
|
||||
\li Select \uicontrol Build > \uicontrol {Rebuild Project} to clean and
|
||||
rebuild the project.
|
||||
@@ -119,17 +125,8 @@
|
||||
For example, for qmake the global setting only affects build configurations
|
||||
that are automatically created when enabling a kit. Also, CMake ignores the
|
||||
global setting.
|
||||
|
||||
\section1 Mixed C++/QML Debugging
|
||||
|
||||
To debug both the C++ and QML parts of your application at the same time,
|
||||
select the \uicontrol {Enable C++} and \uicontrol {Enable QML} checkboxes for both
|
||||
languages in the \uicontrol {Debugger Settings} section in the project
|
||||
\uicontrol{Run Settings}.
|
||||
\endif
|
||||
|
||||
\image qtquick-debugging-settings.png {Debugger settings section in Run Settings}
|
||||
|
||||
\section1 Starting QML Debugging
|
||||
|
||||
To start the application, choose \uicontrol Debug > \uicontrol {Start Debugging}
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
// Copyright (C) 2022 The Qt Company Ltd.
|
||||
// Copyright (C) 2023 The Qt Company Ltd.
|
||||
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
|
||||
|
||||
/*!
|
||||
@@ -6,10 +6,11 @@
|
||||
|
||||
\section1 Enabling Debugging
|
||||
|
||||
\image qtquick-debugging-settings.png "Debugger Settings"
|
||||
\image qtquick-debugger-settings.webp "Debugger Settings"
|
||||
|
||||
To select the languages to debug, select the \uicontrol {Enable C++} and
|
||||
\uicontrol {Enable QML} check boxes.
|
||||
To select the languages to debug, select \uicontrol Automatic
|
||||
or \uicontrol Enabled in \uicontrol {Debugger Settings} >
|
||||
\uicontrol {C++ debugger} and \uicontrol {QML debugger}.
|
||||
|
||||
\note Opening a socket at a well-known port presents a security risk. Anyone
|
||||
on the Internet could connect to the application that you are debugging and
|
||||
@@ -28,6 +29,11 @@
|
||||
|
||||
However, you can usually leave this field empty.
|
||||
|
||||
\note To create a build configuration that supports debugging for a
|
||||
Qt Quick application project, you also need to \l {Using Default Values}
|
||||
{enable QML debugging} either globally or in the \uicontrol {Build Settings}
|
||||
of the project.
|
||||
|
||||
For more information about debugging, see \l{Debugging}.
|
||||
|
||||
//! [run settings debugger]
|
||||
|
||||
Reference in New Issue
Block a user