doc/src/qtquick1/qdeclarativedebugging.qdoc

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
   4 ** Contact: http://www.qt-project.org/
   5 **
   6 ** This file is part of the documentation of the Qt Toolkit.
   7 **
   8 ** $QT_BEGIN_LICENSE:FDL$
   9 ** GNU Free Documentation License
  10 ** Alternatively, this file may be used under the terms of the GNU Free
  11 ** Documentation License version 1.3 as published by the Free Software
  12 ** Foundation and appearing in the file included in the packaging of
  13 ** this file.
  14 **
  15 ** Other Usage
  16 ** Alternatively, this file may be used in accordance with the terms
  17 ** and conditions contained in a signed written agreement between you
  18 ** and Nokia.
  19 **
  20 **
  21 **
  22 **
  23 **
  24 ** $QT_END_LICENSE$
  25 **
  26 ****************************************************************************/
  27
  28 /*!
  29 \page qdeclarativedebugging.html
  30 \inqmlmodule QtQuick 1
  31 \title Debugging QML
  32
  33 \section1 Logging
  34
  35 \c console.log can be used to print debugging information to the console. For example:
  36
  37 \qml
  38 Rectangle {
  39     width: 200; height: 200
  40     MouseArea {
  41         anchors.fill: parent
  42         onClicked: console.log("clicked")
  43     }
  44 }
  45 \endqml
  46
  47 \section1 Debugging Transitions
  48
  49 When a transition doesn't look quite right, it can be helpful to view it in slow
  50 motion to see what is happening more clearly. This functionality is supported
  51 in the \l {QML Viewer} tool: to enable this,
  52 click on the "Debugging" menu, then "Slow Down Animations".
  53
  54
  55 \section1 Debugging module imports
  56
  57 The \c QML_IMPORT_TRACE environment variable can be set to enable debug output
  58 from QML's import loading mechanisms.
  59
  60 For example, for a simple QML file like this:
  61
  62 \qml
  63 import QtQuick 1.0
  64
  65 Rectangle { width: 100; height: 100 }
  66 \endqml
  67
  68 If you set \c {QML_IMPORT_TRACE=1} before running the \l {QML Viewer}
  69 (or your QML C++ application), you will see output similar to this:
  70
  71 \code
  72 QDeclarativeImportDatabase::addImportPath "/qt-sdk/imports"
  73 QDeclarativeImportDatabase::addImportPath "/qt-sdk/bin/QMLViewer.app/Contents/MacOS"
  74 QDeclarativeImportDatabase::addToImport 0x106237370 "." -1.-1 File as ""
  75 QDeclarativeImportDatabase::addToImport 0x106237370 "Qt" 4.7 Library as ""
  76 QDeclarativeImportDatabase::resolveType "Rectangle" = "QDeclarativeRectangle"
  77 \endcode
  78
  79
  80 \section1 Debugging with Qt Creator
  81
  82 \l{http://qt.nokia.com/products/developer-tools}{Qt Creator} provides built-in
  83 support for QML debugging. QML projects and standalone C++ applications that
  84 utilize QML can be debugged on desktops as well as on remote devices.
  85 For more information, see the Qt Creator Manual.
  86
  87 */