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