QQmlDebuggingEnabler Struct

멤버 함수 문서

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

이 함수를 호출한 후 생성된 QML 엔진에 대한 디버깅을 활성화합니다. 디버그 커넥터는 지정된 socketFileName 에서 로컬 소켓을 대기 중인 디버거에 연결하며, mode 가 WaitForClient 인 경우 연결이 설정될 때까지 QML 엔진을 차단합니다. mode 가 지정되지 않은 경우 차단되지 않습니다. 한 번에 하나의 디버그 커넥터만 시작할 수 있습니다. -qmljsdebugger= 명령줄 인수가 지정된 경우, 디버그 커넥터가 이미 시작되었을 수 있습니다. 이 메서드는 새로운 디버그 커넥터가 성공적으로 시작되면 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

[static] QStringList QQmlDebuggingEnabler::debuggerServices()

기본적으로 제공되는 디버거 서비스의 플러그인 키를 가져옵니다. 디버거 서비스를 통해 디버그 클라이언트는 Qml/JavaScript 디버거를 사용하여 중단점을 설정하고, 실행을 일시 중지하며, 식을 평가하는 등 다양한 디버깅 작업을 수행할 수 있습니다. 기본 디버거 서비스의 플러그인 키 목록을 반환합니다.

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

디버깅 또는 프로파일링을 활성화합니다. printWarning 가 true 인 경우, stderr에 다음 경고를 출력합니다:

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

빌드 시점에 QT_ENABLE_QML_DEBUG 또는 CONFIG+=qml_debug 가 전달된 경우, 이 메서드는 시작 시 자동으로 호출됩니다.

어떤 종류의 디버그 커넥터든 시작하기 전에 이 메서드를 반드시 호출해야 합니다. 그렇지 않으면 커넥터가 시작되지 않습니다.

startTcpDebugServer(), connectToLocalDebugger(), startDebugConnector()도 참조하십시오 .

[static] QStringList QQmlDebuggingEnabler::inspectorServices()

기본으로 제공되는 인스펙터 서비스의 플러그인 키를 가져옵니다. 인스펙터 서비스를 통해 디버그 클라이언트는 Qt Quick 에서 시각적 인스펙터 도구를 사용할 수 있습니다. 기본 인스펙터 서비스의 플러그인 키 목록을 반환합니다.

[static] QStringList QQmlDebuggingEnabler::nativeDebuggerServices()

네이티브 디버거와 함께 사용하도록 설계된 디버그 서비스의 플러그인 키를 가져옵니다. 네이티브 디버거는 애플리케이션의 메모리를 직접 읽고 쓰면서 이러한 서비스와 통신합니다. 네이티브 디버거와 함께 사용하도록 설계된 디버그 서비스의 플러그인 키 목록을 반환합니다.

[static] QStringList QQmlDebuggingEnabler::profilerServices()

기본적으로 제공되는 프로파일러 서비스의 이름을 가져옵니다. 프로파일러 서비스를 통해 디버그 클라이언트는 프로파일러를 사용하여 다양한 QML 및 JavaScript 구문은 물론, QtQuick SceneGraph의 실행 시간을 추적할 수 있습니다. 기본 프로파일러 서비스의 플러그인 키 목록을 반환합니다.

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

디버그 커넥터를 통해 사용할 수 있는 서비스를 제한합니다. 커넥터는 기본 플러그인 경로의 "qmltooling" 하위 디렉터리에 있는 플러그인을 스캔합니다. 디버그 커넥터가 활성화되기 전에 이 함수가 호출되지 않으면, 해당 방식으로 발견된 모든 서비스가 모든 클라이언트에서 사용 가능해집니다. 이 함수가 호출되면, services 에 지정된 플러그인 키를 가진 서비스만 사용 가능해집니다.

프로파일링 시 더 나은 성능과 보다 현실적인 프로파일을 얻기 위해 디버거 및 인스펙터 서비스를 비활성화하려면 이 메서드를 사용하십시오. 디버거 서비스는 연결된 모든 JavaScript 엔진을 해석 모드로 전환하여 JIT 컴파일러를 비활성화합니다.

debuggerServices(), profilerServices(), inspectorServices()도 참조하십시오 .

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

이 함수를 호출한 후 생성된 QML 엔진에 대한 디버깅을 활성화합니다. ` pluginName `로 지정된 디버그 커넥터 플러그인이 주어진 ` configuration`를 사용하여 로드되고 시작됩니다. 지원되는 구성 항목과 그 의미는 로드되는 플러그인에 따라 다릅니다. 한 번에 하나의 디버그 커넥터만 시작할 수 있습니다. -qmljsdebugger= 명령줄 인수가 지정된 경우, 디버그 커넥터가 이미 시작되었을 수 있습니다. 이 메서드는 새로운 디버그 커넥터가 성공적으로 시작된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

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

이 함수를 호출한 후 생성된 QML 엔진에 대한 디버깅을 활성화합니다. 디버그 커넥터는 port 에서 hostName 를 수신 대기하며, mode 가 WaitForClient 인 경우 연결을 수신할 때까지 QML 엔진을 차단합니다. mode 가 지정되지 않으면 차단되지 않으며, hostName 가 지정되지 않으면 사용 가능한 모든 인터페이스에서 수신 대기합니다. 한 번에 하나의 디버그 커넥터만 시작할 수 있습니다. -qmljsdebugger= 명령줄 인수가 지정된 경우, 디버그 커넥터가 이미 실행 중일 수 있습니다. 이 메서드는 새로운 디버그 커넥터가 성공적으로 시작되면 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.