Fehlersuche in QML-Anwendungen

Wenn Sie eine Anwendung mit QML entwickeln, gibt es viele Möglichkeiten, mögliche Probleme zu debuggen, auf die Sie stoßen könnten. Die folgenden Abschnitte beschreiben die verfügbaren Debugging-Tools und ihre Verwendung.

Konsolen-API

function f(a, b) {
  console.log("a is ", a, "b is ", b);
}

function f() {
  var x = 12
  console.assert(x == 12, "This will pass");
  console.assert(x > 12, "This will fail");
}

function f() {
    console.time("wholeFunction");
    console.time("firstPart");
    // first part
    console.timeEnd("firstPart");
    // second part
    console.timeEnd("wholeFunction");
}

function f() {
  console.count("f called");
}

function f() {
    console.profile();
    //Call some function that needs to be profiled.
    //Ensure that a client is attached before ending
    //the profiling session.
    console.profileEnd();
}

Alternativ kann auch eine logging category als erstes Argument an eine dieser Funktionen console übergeben werden. Siehe LoggingCategory für weitere Einzelheiten.

Debuggen von Modulimporten

Setzen Sie die Umgebungsvariable QML_IMPORT_TRACE, um die Debug-Ausgabe von QMLs Import-Lademechanismen zu aktivieren.

Zum Beispiel für eine einfache QML-Datei wie diese:

import QtQuick

Rectangle { width: 100; height: 100 }

Wenn Sie QML_IMPORT_TRACE=1 setzen, bevor Sie das QML Runtime Tool oder Ihre QML C++ Anwendung ausführen, werden Sie eine Ausgabe ähnlich der folgenden sehen:

QQmlImportDatabase::addImportPath "/qt-sdk/imports"
QQmlImportDatabase::addImportPath "/qt-sdk/bin/QMLViewer.app/Contents/MacOS"
QQmlImportDatabase::addToImport 0x106237370 "." -1.-1 File as ""
QQmlImportDatabase::addToImport 0x106237370 "Qt" 4.7 Library as ""
QQmlImportDatabase::resolveType "Rectangle" = "QDeclarativeRectangle"

QML-Debugging-Infrastruktur

Das Qt Qml Modul bietet Dienste zum Debuggen, Überprüfen und Profilieren von Anwendungen über einen TCP-Port oder einen lokalen Socket.

Aktivieren der Infrastruktur

Wenn Sie Ihre Anwendung kompilieren, müssen Sie die Debugging-Infrastruktur explizit aktivieren. Wenn Sie qmake verwenden, können Sie die Konfigurationsparameter in die Projektdatei .pro einfügen:

• Qt Quick 1: CONFIG+=declarative_debug
• Qt Quick 2: CONFIG+=qml_debug

Wenn Sie ein anderes Build-System verwenden, können Sie die folgenden Defines an den Compiler übergeben:

• Qt Quick 1: QT_DECLARATIVE_DEBUG
• Qt Quick 2: QT_QML_DEBUG

QML debugging is enabled. Only use this in a safe environment.

Starten von Anwendungen

Um das Debugging zu aktivieren - von Anfang an oder um später einen Debugger anzuschließen - starten Sie die Anwendung mit den folgenden Argumenten:

-qmljsdebugger=port:<port_from>[,port_to][,host:<ip address>][,block][,file:<local socket>][,services:<comma-separated list of services to enable>]

Wobei:

• Das obligatorische port_from gibt entweder den Debugging-Port oder den Startport eines Portbereichs an, wenn port_to angegeben ist.
• die optionale ip address gibt die IP-Adresse des Rechners an, auf dem die Anwendung läuft
• die optionale Angabe block verhindert, dass die Anwendung ausgeführt wird, bis der Debug-Client eine Verbindung zum Server herstellt
• die optionale file spezifiziert den lokalen Socket.
• die optionale services gibt die zu aktivierenden Dienste an; die Voreinstellung ist, dass alle gefundenen Dienste aktiviert werden. Beachten Sie, dass der Dienst v4 debug das JIT deaktiviert.

Nachdem die Anwendung erfolgreich gestartet wurde, wird die folgende Meldung angezeigt:

QML Debugger: Waiting for connection on port <port_number> oder QML Debugger: Connecting to socket at <file>"

Verbinden mit Anwendungen

Wenn die Anwendung läuft, kann sich eine IDE oder ein Tool, das das Binärprotokoll implementiert, mit dem offenen Port verbinden.

Qt stellt ein qmlprofiler Kommandozeilen-Tool zur Verfügung, um Profiling-Daten in einer Datei zu erfassen. Um dieses Tool zu starten, geben Sie den folgenden Befehl ein:

qmlprofiler -p <port> -attach <ip address>

Debuggen mit Qt Creator

Qt Creator verwendet die Debugging-Infrastruktur zum Debuggen, Untersuchen und Erstellen von Profilen von Qt Quick -Anwendungen auf dem Desktop und auf entfernten Geräten. Qt Creator bietet integrierte Clients zum Debuggen von JavaScript, zum Untersuchen des Objektbaums und zum Erstellen von Profilen der Aktivitäten einer QML-Engine. Weitere Informationen finden Sie unter Qt Creator: Debugging Qt Quick Projekte.