QQmlDebuggingEnabler Struct

Documentation des fonctions membres

[static] bool QQmlDebuggingEnabler::connectToLocalDebugger(const QString &socketFileName, QQmlDebuggingEnabler::StartMode mode = DoNotWaitForClient)

Active le débogage pour les moteurs QML créés après l'appel de cette fonction. Le connecteur de débogage se connectera à un débogueur attendant sur un socket local à l'socketFileName indiquée et bloquera le moteur QML jusqu’à ce que la connexion soit établie si mode est WaitForClient. Si mode n’est pas spécifié, il n’y aura pas de blocage. Vous ne pouvez démarrer qu’un seul connecteur de débogage à la fois. Un connecteur de débogage peut déjà avoir été lancé si l'argument de ligne de commande -qmljsdebugger= a été fourni. Cette méthode renvoie true si un nouveau connecteur de débogage a été lancé avec succès, ou false dans le cas contraire.

[static] QStringList QQmlDebuggingEnabler::debuggerServices()

Récupère les clés de plugin des services de débogage fournis par défaut. Les services de débogage permettent à un client de débogage d'utiliser un débogueur Qml/JavaScript afin de définir des points d'arrêt, de suspendre l'exécution, d'évaluer des expressions et d'effectuer d'autres tâches de débogage similaires. Renvoie une liste des clés de plugin des services de débogage par défaut.

[static] void QQmlDebuggingEnabler::enableDebugging(bool printWarning)

Activer le débogage ou le profilage. Si printWarning vaut true, afficher l'avertissement suivant sur stderr :

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

Cette méthode est automatiquement appelée au démarrage si QT_ENABLE_QML_DEBUG ou CONFIG+=qml_debug est passé lors de la compilation.

Cette méthode doit être appelée d'une manière ou d'une autre avant de démarrer un connecteur de débogage, quel qu'il soit. Sinon, le connecteur refusera de démarrer.

Voir également startTcpDebugServer(), connectToLocalDebugger() et startDebugConnector().

[static] QStringList QQmlDebuggingEnabler::inspectorServices()

Récupère les clés de plugin des services d'inspection fournis par défaut. Les services d'inspection permettent à un client de débogage d'utiliser un outil d'inspection visuelle pour Qt Quick. Renvoie une liste des clés de plugin des services d'inspection par défaut.

[static] QStringList QQmlDebuggingEnabler::nativeDebuggerServices()

Récupère les clés de plugin des services de débogage conçus pour être utilisés avec un débogueur natif. Le débogueur natif communiquera avec ces services en lisant et en écrivant directement dans la mémoire de l'application. Renvoie une liste des clés de plugin des services de débogage conçus pour être utilisés avec un débogueur natif.

[static] QStringList QQmlDebuggingEnabler::profilerServices()

Récupère les noms des services de profilage fournis par défaut. Les services de profilage permettent à un client de débogage d’utiliser un outil de profilage et de suivre le temps d’exécution de diverses constructions QML et JavaScript, ainsi que du SceneGraph d’ QtQuick. Renvoie une liste des clés de plug-in des services de profilage par défaut.

[static] void QQmlDebuggingEnabler::setServices(const QStringList &services)

Limite les services disponibles via le connecteur de débogage. Le connecteur analysera les plugins situés dans le sous-répertoire « qmltooling » du chemin d’accès par défaut aux plugins. Si cette fonction n’est pas appelée avant l’activation du connecteur de débogage, tous les services détectés de cette manière seront accessibles à n’importe quel client. Si cette fonction est appelée, seuls les services dont les clés de plugin sont indiquées dans services seront disponibles.

Utilisez cette méthode pour désactiver les services du débogueur et de l’inspecteur lors du profilage afin d’obtenir de meilleures performances et des profils plus réalistes. Le service du débogueur mettra tout moteur JavaScript auquel il se connecte en mode interprété, désactivant ainsi le compilateur JIT.

Voir également debuggerServices(), profilerServices() et inspectorServices().

[static] bool QQmlDebuggingEnabler::startDebugConnector(const QString &pluginName, const QVariantHash &configuration = QVariantHash())

Active le débogage pour les moteurs QML créés après l’appel de cette fonction. Un plugin de connecteur de débogage spécifié par ` pluginName ` sera chargé et lancé à l’aide de l’ configuration` indiquée. Les entrées de configuration prises en charge et leur sémantique dépendent du plugin chargé. Vous ne pouvez lancer qu’un seul connecteur de débogage à la fois. Un connecteur de débogage peut déjà avoir été lancé si l'argument de ligne de commande -qmljsdebugger= a été fourni. Cette méthode renvoie true si un nouveau connecteur de débogage a été lancé avec succès, ou false dans le cas contraire.

[static] bool QQmlDebuggingEnabler::startTcpDebugServer(int port, QQmlDebuggingEnabler::StartMode mode = DoNotWaitForClient, const QString &hostName = QString())

Active le débogage pour les moteurs QML créés après l'appel de cette fonction. Le connecteur de débogage écoutera sur l'port à l'adresse hostName et bloquera le moteur QML jusqu'à ce qu'il reçoive une connexion si mode est défini sur WaitForClient. Si mode n'est pas spécifié, il ne bloquera pas le moteur, et si hostName n'est pas spécifié, il écoutera sur toutes les interfaces disponibles. Vous ne pouvez démarrer qu'un seul connecteur de débogage à la fois. Un connecteur de débogage a peut-être déjà été lancé si l’argument de ligne de commande -qmljsdebugger= a été fourni. Cette méthode renvoie true si un nouveau connecteur de débogage a été lancé avec succès, ou false dans le cas contraire.