feedc0de/qt-creator
1
0
Fork 0
forked from qt-creator/qt-creator
Code Pull Requests Activity

Doc: Add info about installing CDB Debugger Support on Windows

Browse Source 
Move the information out of a table, because the table format does
not really work with so much text.

Change-Id: I8053c76ee0f43a1b35ed66fe0e2335106b1063dd
Reviewed-by: hjk <hjk@qt.io>
Reviewed-by: David Schulz <david.schulz@qt.io>
This commit is contained in:
Leena Miettinen
2018-02-01 15:51:04 +01:00
parent 2d6995ae25
commit 2bde6a5846
1 changed files with 53 additions and 52 deletions
Download Patch File Download Diff File Expand all files Collapse all files

105
doc/src/debugger/creator-debugger-setup.qdoc
View File

@@ -170,67 +170,68 @@
\section1 Installing Native Debuggers
Check the table below for the supported versions and other important
information about installing native debuggers.
The following sections provide information about installing native
debuggers.
\table
\header
\li Native Debugger
\li Notes
\row
\li GDB
\li On Windows, use the Python-enabled GDB versions that is bundled
with the Qt package or comes with recent versions of MinGW. On
most Linux distributions the GDB builds shipped with the system
are sufficient. You can also build your own. Follow the
instructions in \l{http://wiki.qt.io/QtCreator_Build_Gdb}
{Building GDB}. Builds of GDB shipped with Xcode on \macos are no
longer supported.
\section2 GDB
\row
\li Debugging tools for Windows
\li To use the CDB debugger, you must install the
\e{Debugging tools for Windows}. You can download them from
\l{https://developer.microsoft.com/windows/downloads/windows-10-sdk}
{Download and Install Debugging Tools for Windows} as part of the Windows SDK.
On Windows, use the Python-enabled GDB versions that is bundled
with the Qt package or comes with recent versions of MinGW. On
most Linux distributions, the GDB builds shipped with the system
are sufficient.
\note Visual Studio does not include the Debugging tools needed,
and therefore, you must install them separately.
You can also build your own GDB, as instructed in
\l{http://wiki.qt.io/QtCreator_Build_Gdb}{Building GDB}.
The pre-built \QSDK for Windows makes use of the library if it
is present on the system. When manually building \QC using
the Microsoft Visual C++ Compiler, the build process checks for
the required files in
\c{"%ProgramFiles%\Debugging Tools for Windows"}.
Builds of GDB shipped with Xcode on \macos are no longer supported.
It is highly recommended that you add the Symbol Server provided
by Microsoft to the symbol search path of the debugger. The
Symbol Server provides you with debugging informaton for the
operating system libraries for debugging Windows applications.
For more information, see
\l{Setting CDB Paths on Windows}.
\section2 Debugging Tools for Windows
\row
\li Debugging tools for \macos
\li The Qt binary distribution contains both debug and release
variants of the libraries. But you have to explicitly tell the
runtime linker that you want to use the debug libraries even if
your application is compiled as debug, as release is the default
library.
To use the CDB debugger, you must install the
\e{Debugging tools for Windows}. You can download them from
\l{https://developer.microsoft.com/windows/downloads/windows-10-sdk}
{Download and Install Debugging Tools for Windows} as part of the Windows
SDK.
If you use a qmake based project in \QC, you can set a flag in
your \l{glossary-run-config}{run configuration}, in
\uicontrol Projects mode. In the run configuration, select
\uicontrol{Use debug version of frameworks}.
\note Visual Studio does not include the Debugging tools needed,
and therefore, you must install them separately.
For more detailed information about debugging on \macos,
see: \l{http://developer.apple.com/library/mac/#technotes/tn2124/_index.html#//apple_ref/doc/uid/DTS10003391}
{Mac OS X Debugging Magic}.
In addition, you must select \uicontrol {Qt Creator CDB Debugger Support}
(in \uicontrol Qt > \uicontrol Tools > \uicontrol {\QC}) when you install
Qt or the stand-alone \QC.
\row
\li LLDB
\li We recommend using the LLDB version that is delivered with Xcode 5.
\endtable
When manually building \QC using
the Microsoft Visual C++ Compiler, the build process checks for
the required files in
\c{"%ProgramFiles%\Debugging Tools for Windows"}.
It is highly recommended that you add the Symbol Server provided
by Microsoft to the symbol search path of the debugger. The
Symbol Server provides you with debugging informaton for the
operating system libraries for debugging Windows applications.
For more information, see
\l{Setting CDB Paths on Windows}.
\section2 Debugging Tools for \macos
The Qt binary distribution contains both debug and release
variants of the libraries. But you have to explicitly tell the
runtime linker that you want to use the debug libraries even if
your application is compiled as debug, as release is the default
library.
If you use a qmake based project in \QC, you can set a flag in
your \l{glossary-run-config}{run configuration}, in
\uicontrol Projects mode. In the run configuration, select
\uicontrol{Use debug version of frameworks}.
For more detailed information about debugging on \macos,
see: \l{http://developer.apple.com/library/mac/#technotes/tn2124/_index.html#//apple_ref/doc/uid/DTS10003391}
{Mac OS X Debugging Magic}.
\section2 LLDB
We recommend using the LLDB version that is delivered with the latest Xcode.
\section1 Mapping Source Paths