qmlprofiler
qmlprofiler 는 애플리케이션에서 QML 추적 데이터를 수집합니다. 수집된 데이터는 Qt Creator 에서 시각화할 수 있습니다.
qmlprofiler 가 애플리케이션을 프로파일링할 수 있도록 하려면, QML 디버깅 인프라가 활성화된 상태로 애플리케이션을 빌드해야 합니다.
자세한 내용은 QML Profiler 참조하십시오.
| 사용법 |
|---|
| qmlprofiler [옵션] 실행 파일 [매개변수...] |
옵션
| 옵션 | 설명 |
|---|---|
-a, --attach <hostname> | 로컬에서 애플리케이션을 시작하는 대신, <호스트명>에서 이미 실행 중인 애플리케이션에 연결합니다. |
-p, --port <port> | TCP 포트 <port>에 연결합니다. 기본값은 3768입니다. |
-o, --output <file> | 추적 데이터를 <file>에 저장합니다. 기본적으로 데이터는 표준 출력으로 전송됩니다. |
--record <on|off> | 'off'로 설정된 경우, QML 엔진이 시작될 때 즉시 데이터 기록을 시작하지 않고, 대화형으로 또는 JavaScript의 console.profile() 함수를 사용하여 기록을 시작합니다. 기본적으로 기록은 즉시 시작됩니다. |
--include <feature,...> | 기록할 기능의 쉼표로 구분된 목록입니다. 기본적으로 QML 엔진이 지원하는 모든 기능이 기록됩니다. --include 가 지정된 경우, 지정된 기능만 기록됩니다. qmlprofiler는 다음 기능을 인식합니다: javascript, memory, pixmapcache, scenegraph, animations, painting, compiling, creating, binding, handlingsignal, inputevents, debugmessages, quick3d. |
--exclude <feature,...> | 기록 시 제외할 기능의 쉼표로 구분된 목록입니다. 기본적으로 QML 엔진에서 지원하는 모든 기능이 기록됩니다. qmlprofiler가 인식하는 기능에 대해서는 --include 를 참조하십시오. |
--interactive | 명령줄에서 기록 작업을 수동으로 제어합니다. 이 경우 애플리케이션이 종료되더라도 프로파일러는 자동으로 종료되지 않습니다. 다음 명령을 사용할 수 있습니다:
|
--verbose | 디버깅 출력을 표시합니다. |
-h, --help | 명령줄 옵션에 대한 도움말을 표시합니다. |
--help-all | 일반 Qt 옵션을 포함한 도움말을 표시합니다. |
-v, --version | 버전 정보를 표시합니다. |
인수
| 인수 | 설명 |
|---|---|
| 실행 파일 | QML 문서를 불러오는 실행 파일의 경로입니다. |
| 매개변수 | 실행 파일의 인수 |
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
