Review Request: Make it possible to use QtCreator QML profiler and debugger with KDE Applications

[Aurélien Gâteau]

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

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-core-devel/attachments/20120921/cdd45d46/attachment.htm>