Depuración de aplicaciones QML

Cuando desarrolle una aplicación con QML, existen muchas formas de depurar los posibles problemas a los que pueda enfrentarse. Las secciones siguientes describen las herramientas de depuración disponibles y cómo utilizarlas.

API de consola

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();
}

Alternativamente, se puede pasar un logging category como primer argumento a cualquiera de estas funciones console. Consulte LoggingCategory para obtener más información.

Importación de módulos de depuración

Establezca la variable de entorno QML_IMPORT_TRACE para habilitar la salida de depuración de los mecanismos de carga de importaciones de QML.

Por ejemplo, para un archivo QML simple como este:

import QtQuick

Rectangle { width: 100; height: 100 }

Si establece QML_IMPORT_TRACE=1 antes de ejecutar la herramientaQML Runtime o su aplicación QML C++, verá una salida similar a:

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"

Infraestructura de depuración QML

El módulo Qt Qml proporciona servicios para depurar, inspeccionar y crear perfiles de aplicaciones a través de un puerto TCP o un socket local.

Habilitación de la infraestructura

Cuando compiles tu aplicación, debes habilitar explícitamente la infraestructura de depuración. Si utilizas qmake, puedes añadir los parámetros de configuración de CONFIG+=qml_debug al archivo del proyecto .pro.

Si utilizas otro sistema de compilación, puedes pasar la definición QT_QML_DEBUG al compilador:

Inicio de aplicaciones

Para habilitar la depuración -desde el principio o para conectar un depurador más tarde- inicie la aplicación con los siguientes argumentos:

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

Donde

• el obligatorio port_from especifica el puerto de depuración o el puerto de inicio de un rango de puertos cuando se especifica port_to
• el opcional ip address especifica la dirección IP del host donde se ejecuta la aplicación
• el opcional block impide que la aplicación se ejecute hasta que el cliente de depuración se conecte al servidor
• la opción file especifica el socket local.
• el opcional services especifica los servicios a habilitar; por defecto son todos los que se encuentran. Tenga en cuenta que el servicio v4 debug desactiva el JIT.

Una vez que la aplicación se ha iniciado correctamente, muestra el siguiente mensaje:

QML Debugger: Waiting for connection on port <port_number>

o

QML Debugger: Connecting to socket at <file>

Conexión a aplicaciones

Cuando la aplicación se está ejecutando, un IDE o una herramienta que implemente el protocolo binario puede conectarse al puerto abierto.

Depuración con Qt Creator

Qt Creator utiliza la infraestructura de depuración para depurar, inspeccionar y perfilar aplicaciones QML tanto en el escritorio como en dispositivos remotos. Qt Creator proporciona clientes integrados para depurar JavaScript, inspeccionar el árbol de objetos y perfilar las actividades de un motor QML. Para obtener más información, consulte Qt Creator: Depuración de proyectos Qt Quick .