[prev in list] [next in list] [prev in thread] [next in thread]
List: kde-core-devel
Subject: Review Request: Make it possible to use QtCreator QML profiler and debugger with KDE Applications
From: Aurélien Gâteau <agateau () kde ! org>
Date: 2012-09-21 15:29:30
Message-ID: 20120921152930.6519.29516 () vidsolbach ! de
[Download RAW message or body]
-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
http://git.reviewboard.kde.org/r/106527/
-----------------------------------------------------------
Review request for kdelibs, Plasma, Marco Martin, and David Faure.
Description
-------
QtCreator comes with a handy QML profiler and debugger, but it relies on tricky \
command-line parsing and #define setup. This patch makes it possible to use it with \
KDE applications. It does two things:
1. Add the "qmljsdebugger" option to the list of qt command-line options, with a hack \
to ensure it is passed unaltered (as in, using '=' to separate argument from value, \
rather than ' ') 2. Add a static method to KDeclarative to enable the debugger when \
the "qmljsdebugger" command-line option is defined.
I am not entirely sure about #2 as it means linking to libkdeclarative even if it is \
not used (do we expect all KDE apps to use KDeclarative?). The alternative to using \
it is to tell developers who want to use the QML debugger to add one of the following \
snippets in their code.
Either:
// Add this snippet in one of your .cpp file.
// Me sure it appears before any QDeclarative include.
#define QT_DECLARATIVE_DEBUG
#include <QtDeclarative/qdeclarativedebug.h>
or:
// Add this include to the file containing your main() function
#include <QtDeclarative/qdeclarativedebug.h>
// Add this to your main() function.
// Make sure it is called before instantiating a QDeclarativeView.
QDeclarativeDebuggingEnabler enabler;
Diffs
-----
experimental/libkdeclarative/kdeclarative.h 5e404c7
experimental/libkdeclarative/kdeclarative.cpp 34383c0
kdecore/kernel/kcmdlineargs.cpp 2da636f
Diff: http://git.reviewboard.kde.org/r/106527/diff/
Testing
-------
- Patch plasmoidviewer to call KDeclarative::setupQmlJsDebugger()
- Run it through qmlprofiler:
qmlprofiler plasmoidviewer org.kde.example.widgetgallery
- Press r<return> (in the terminal) while it is running to start recording
- Press q<return> to stop recording => application should stop and a file named \
"plasmoidviewer_$date_$time.qtd" should be created
- Open Qt Creator, click the "Analyze" sidebar button
- Right click in the profiler area (bottom right) and select "Load QML Trace"
- Select the "plasmoidviewer_$date_$time.qtd" file
Thanks,
Aurélien Gâteau
[Attachment #3 (text/html)]
<html>
<body>
<div style="font-family: Verdana, Arial, Helvetica, Sans-Serif;">
<table bgcolor="#f9f3c9" width="100%" cellpadding="8" style="border: 1px #c9c399 \
solid;"> <tr>
<td>
This is an automatically generated e-mail. To reply, visit:
<a href="http://git.reviewboard.kde.org/r/106527/">http://git.reviewboard.kde.org/r/106527/</a>
</td>
</tr>
</table>
<br />
<table bgcolor="#fefadf" width="100%" cellspacing="0" cellpadding="8" \
style="background-image: \
url('http://git.reviewboard.kde.org/media/rb/images/review_request_box_top_bg.png'); \
background-position: left top; background-repeat: repeat-x; border: 1px black \
solid;"> <tr>
<td>
<div>Review request for kdelibs, Plasma, Marco Martin, and David Faure.</div>
<div>By Aurélien Gâteau.</div>
<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Description </h1>
<table width="100%" bgcolor="#ffffff" cellspacing="0" cellpadding="10" \
style="border: 1px solid #b8b5a0"> <tr>
<td>
<pre style="margin: 0; padding: 0; white-space: pre-wrap; white-space: \
-moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: \
break-word;">QtCreator comes with a handy QML profiler and debugger, but it relies on \
tricky command-line parsing and #define setup. This patch makes it possible to use it \
with KDE applications. It does two things:
1. Add the "qmljsdebugger" option to the list of qt command-line options, \
with a hack to ensure it is passed unaltered (as in, using '=' to separate \
argument from value, rather than ' ') 2. Add a static method to KDeclarative \
to enable the debugger when the "qmljsdebugger" command-line option is \
defined.
I am not entirely sure about #2 as it means linking to libkdeclarative even if it is \
not used (do we expect all KDE apps to use KDeclarative?). The alternative to using \
it is to tell developers who want to use the QML debugger to add one of the following \
snippets in their code.
Either:
// Add this snippet in one of your .cpp file.
// Me sure it appears before any QDeclarative include.
#define QT_DECLARATIVE_DEBUG
#include <QtDeclarative/qdeclarativedebug.h>
or:
// Add this include to the file containing your main() function
#include <QtDeclarative/qdeclarativedebug.h>
// Add this to your main() function.
// Make sure it is called before instantiating a QDeclarativeView.
QDeclarativeDebuggingEnabler enabler;</pre>
</td>
</tr>
</table>
<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Testing </h1>
<table width="100%" bgcolor="#ffffff" cellspacing="0" cellpadding="10" style="border: \
1px solid #b8b5a0"> <tr>
<td>
<pre style="margin: 0; padding: 0; white-space: pre-wrap; white-space: \
-moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: \
break-word;">- Patch plasmoidviewer to call \
KDeclarative::setupQmlJsDebugger()
- Run it through qmlprofiler:
qmlprofiler plasmoidviewer org.kde.example.widgetgallery
- Press r<return> (in the terminal) while it is running to start recording
- Press q<return> to stop recording => application should stop and a file \
named "plasmoidviewer_$date_$time.qtd" should be created
- Open Qt Creator, click the "Analyze" sidebar button
- Right click in the profiler area (bottom right) and select "Load QML \
Trace"
- Select the "plasmoidviewer_$date_$time.qtd" file</pre>
</td>
</tr>
</table>
<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Diffs</b> </h1>
<ul style="margin-left: 3em; padding-left: 0;">
<li>experimental/libkdeclarative/kdeclarative.h <span style="color: \
grey">(5e404c7)</span></li>
<li>experimental/libkdeclarative/kdeclarative.cpp <span style="color: \
grey">(34383c0)</span></li>
<li>kdecore/kernel/kcmdlineargs.cpp <span style="color: grey">(2da636f)</span></li>
</ul>
<p><a href="http://git.reviewboard.kde.org/r/106527/diff/" style="margin-left: \
3em;">View Diff</a></p>
</td>
</tr>
</table>
</div>
</body>
</html>
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic