Fehlerbehebung bei QML-Anwendungen

Wenn Sie eine Anwendung mit QML entwickeln, gibt es viele Möglichkeiten, mögliche Probleme zu beheben, auf die Sie stoßen könnten. In den folgenden Abschnitten werden die verfügbaren Debugging-Tools und deren Verwendung beschrieben.

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 ein ` logging category ` als erstes Argument an jede dieser „ console “-Funktionen übergeben werden. Weitere Details findest du unter LoggingCategory.

Debugging von Modulimporten

Setzen Sie die Umgebungsvariable ` QML_IMPORT_TRACE `, um die Debug-Ausgabe der Import-Lademekanismen von QML zu aktivieren.

Beispielsweise 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, sehen Sie eine Ausgabe, die in etwa wie folgt aussieht:

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 Profiling 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 CMake verwenden, können Sie „ -DCMAKE_CXX_FLAGS_INIT=-DQT_QML_DEBUG “ als Argument an „ cmake “ in der Befehlszeile übergeben, um die Infrastruktur nur für einen bestimmten Build zu aktivieren. Sie können sie auch dauerhaft in Ihrer „CMakeLists.txt“-Datei aktivieren, indem Sie den folgenden Codeausschnitt hinzufügen:

qt_add_executable(MyApp
...
)

target_compile_definitions(MyApp PRIVATE QT_QML_DEBUG)

Wenn Sie qmake verwenden, können Sie die Konfigurationsparameter „ CONFIG+=qml_debug “ zur Projektdatei „ .pro “ hinzufügen oder sie als Argument über die Befehlszeile übergeben.

Wenn Sie ein anderes Build-System verwenden, müssen Sie die Definition „ QT_QML_DEBUG “ über die Mittel des jeweiligen Build-Systems an den Compiler übergeben.

Anwendungen starten

Um das Debuggen zu aktivieren – entweder von Beginn 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>]

Dabei gilt:

• das obligatorische Argument „ port_from “ gibt entweder den Debugging-Port oder, wenn „ port_to “ angegeben ist, den Startport eines Portbereichs an
• die optionale Angabe „ ip address “ die IP-Adresse des Hosts angibt, auf dem die Anwendung ausgeführt wird
• das optionale „ block “ verhindert, dass die Anwendung ausgeführt wird, bis der Debug-Client eine Verbindung zum Server herstellt
• Der optionale Parameter „ file “ gibt den lokalen Socket an.
• Die optionale Angabe „ services “ legt fest, welche Dienste aktiviert werden sollen; standardmäßig werden alle gefundenen Dienste aktiviert. Beachten Sie, dass der Dienst „ v4 debug “ das JIT deaktiviert.

Nachdem die Anwendung erfolgreich gestartet wurde, zeigt sie die folgende Meldung an:

QML Debugger: Waiting for connection on port <port_number>

oder

QML Debugger: Connecting to socket at <file>

Verbindung zu Anwendungen herstellen

Wenn die Anwendung läuft, kann eine IDE oder ein Tool, das das Binärprotokoll implementiert, eine Verbindung zum offenen Port herstellen.

Debugging mit Qt Creator

Qt Creator nutzt die Debugging-Infrastruktur, um QML-Anwendungen sowohl auf dem Desktop als auch auf Remote-Geräten zu debuggen, zu untersuchen und zu profilieren. „ Qt Creator “ bietet integrierte Clients zum Debuggen von JavaScript, zum Untersuchen des Objektbaums und zum Profilieren der Aktivitäten einer QML-Engine. Weitere Informationen finden Sie unter Qt Creator: Debugging von „ Qt Quick “-Projekten.

Das Debuggen mit Qt Extension for Visual Studio Code

Qt Extension for Visual Studio Code bietet integrierte Clients zum Debuggen von JavaScript und zum Profiling der Aktivitäten der QML-Engine. Weitere Informationen finden Sie unter Qt Extension for Visual Studio Code: Debuggen von „ Qt Quick “-Anwendungen.