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:
Leena Miettinen
2023-06-20 16:24:07 +02:00
parent 933d9223c9
commit ff856ed030
4 changed files with 22 additions and 19 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.4 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.5 KiB

View File

@@ -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}

View File

@@ -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]