도구 및 유틸리티
Qt는 빌드 구성, 자산 전처리, 인터페이스 설명(Protobuf, gRPC, D-Bus, SCXML, OPC UA, Remote Objects), QML 코드 실행 및 분석, 번역 관리, 대상 플랫폼에 대한 배포, 3D 자산 가져오기 등 전체 개발 워크플로우를 아우르는 포괄적인 세트를 제공합니다.
이 페이지에 나열된 도구는 Qt 프레임워크에 포함되어 있으며 Qt와 함께 설치됩니다. Qt Creator, IDE 확장 기능, AI 툴, QA 도구 및 상용 애드온을 포함한 더 광범위한 Qt 생태계에 대해서는 qt.io의 Qt 개발 도구 및 Qt QA 소프트웨어 도구를 참조하십시오.
출처를 신뢰할 수 없는 프로젝트에서 이러한 도구를 안전하게 실행하는 방법에 대한 지침은 ‘Qt 개발자 도구 안전하게 사용하기’를 참조하십시오.
빌드 시스템
Qt의 빌드 구성 및 프로젝트 파일 생성을 담당하는 도구입니다.
| 도구 | 설명 |
|---|---|
| qmake | Qt의 전통적인 빌드 시스템입니다. ` .pro ` 프로젝트 파일로부터 플랫폼별 Makefile을 생성합니다. |
| qt-cmake | Qt의 주요 빌드 시스템은 CMake입니다. qt-cmake는 Qt 설치 위치를 자동으로 찾아주는 CMake 래퍼로, Qt 프로젝트를 구성할 때 CMAKE_PREFIX_PATH 를 설정할 필요가 없습니다. |
코드 생성기
클래스 선언이나 인터페이스 및 프로토콜 설명 파일에서 C++ 소스 코드를 생성하는 도구입니다.
| 도구 | 설명 |
|---|---|
| Meta-Object Compiler (moc) | Qt 매크로를 사용하는 C++ 클래스 선언을 처리하여, 시그널 및 슬롯, 동적 속성, 런타임 유형 정보를 구동하는 인트로스펙션 코드를 생성합니다. |
| Qt D-Bus XML 컴파일러 (qdbusxml2cpp) | D-Bus 인트로스펙션 XML 설명에서 C++ 프록시 및 어댑터 클래스를 생성합니다. |
| Qt SCXML 컴파일러 (qscxmlc) | SCXML 상태 머신 설명을 Qt 애플리케이션에 직접 통합되는 C++ 클래스로 컴파일합니다. |
| Qt Remote Objects 컴파일러 (repc) | .rep 인터페이스 파일로부터 소스 및 복제본 C++ 클래스를 생성하여 Qt Remote Objects. |
| Qt OPC UA 데이터 유형 생성기 (qopcuaxmldatatypes2cpp) | OPC UA NodeSet2 XML 파일에서 C++ 데이터 유형 코드를 생성하여 다음에서 사용할 수 있도록 합니다. Qt OPC UA. |
| qtgrpcgen | .proto 파일에서 Qt와 호환되는 gRPC 클라이언트 및 서버 스텁 C++ 클래스를 생성합니다. |
| Qt Jenny: Java 코드 생성기 | Java API용 C++ 래퍼 클래스를 생성하여, Android에서 Java 또는 Kotlin을 통해 Qt API를 호출할 수 있게 합니다. |
| User Interface Compiler (uic) | Qt Designer 에서 생성된 .ui 양식 파일을 C++ 헤더 파일로 변환합니다. |
애셋 컨디셔닝
소스 에셋을 전처리하고 빌드 또는 런타임에서 사용되는 형식으로 변환하는 도구: UI 폼, 바이너리 리소스, 셰이더, 확장 가능한 벡터 그래픽, 거리 필드 아틀라스 및 애니메이션 파일.
| 도구 | 설명 |
|---|---|
| Resource Compiler (rcc) | 이미지, QML 파일, 번역 파일과 같은 애플리케이션 리소스를 애플리케이션 바이너리에 포함시키거나 독립형 .rcc 파일로 생성합니다. |
| svgtoqml | Qt Quick Shapes를 사용하여 SVG 파일을 QML 컴포넌트로 변환함으로써, 래스터 이미지에 의존하지 않는 확장 가능한 벡터 그래픽을 구현합니다. |
| Qt Shader Baker (qsb) | GLSL 셰이더를 Vulkan, Metal, Direct3D 및 OpenGL 백엔드 전반에 걸쳐 Qt의 그래픽 스택에서 사용할 수 있는 다중 대상 패키지 형식(.qsb)으로 컴파일합니다. |
| Qt Distance Field Generator | 텍스트 렌더링을 위한 거리 필드 텍스처 아틀라스를 미리 생성하여, 리소스가 제한된 임베디드 타겟에서 시작 시간을 단축합니다. |
| lottietoqml | Adobe After Effects 및 호환 도구에서 내보낸 Lottie JSON 애니메이션 파일을 다음을 사용하여 QML 컴포넌트로 변환합니다. Qt Lottie Animation. |
QML 컴파일
QML 및 JavaScript 파일을 바이트코드나 네이티브 C++로 미리 컴파일하여 런타임 시 시작 비용을 줄여주는 도구입니다.
| 도구 | 설명 |
|---|---|
| QML 스크립트 컴파일러 | QML 및 JavaScript 파일 내의 함수와 표현식을 QML 엔진에서 해석하거나 JIT(Just-in-time) 컴파일할 수 있는 바이트코드로 컴파일합니다. |
| QML 타입 컴파일러 | QML 유형을 사용자 코드의 일부로 사전 컴파일되는 C++ 유형으로 변환합니다. |
포맷터 및 린터
QML 소스 파일을 분석하고 서식을 조정하는 도구입니다.
| 도구 | 설명 |
|---|---|
| qmllint | QML 파일용 정적 분석기입니다. 개발 단계에서 바인딩 오류, 더 이상 사용되지 않는 API 사용 및 기타 일반적인 실수를 감지합니다. |
| qmlformat | QML 코딩 규약에 따라 QML 파일을 포맷팅합니다. |
| QML Language Server | LSP(Language Server Protocol)를 지원하는 모든 편집기에서 코드 완성, 정의 위치로 이동, 실시간 진단 기능을 제공하는 LSP 호환 언어 서버입니다. |
| qmlcontextpropertydump | C++ 소스 폴더를 스캔하여 잠재적인 컨텍스트 속성 정의를 찾아내고, 이를 qmllint가 읽을 수 있는 형식으로 저장하며 QML Language Server. |
3D 자산
3D 콘텐츠를 가져오고 변환하며, 빌드 시 물리 충돌 데이터를 전처리하는 도구입니다.
| 도구 | 설명 |
|---|---|
| Balsam 자산 가져오기 도구 | FBX, glTF 2, OBJ 등의 형식으로 된 3D 에셋을 임포트하여 Qt Quick 3D 의 네이티브 형식으로 변환합니다. |
| Balsam UI | Balsam 도구를 위한 그래픽 프론트엔드입니다. |
| Cooker | 빌드 시점에 충돌 메쉬를 사전 처리하고 베이킹하여 Qt Quick 3D Physics 빌드 시점에 수행하여, 대상 장치에서 실행 시 발생하는 부하를 방지합니다. |
| 머티리얼 에디터 (materialeditor) | CustomMaterials 를 제작하기 위한 GUI 도구입니다. Qt Quick 3D. |
| 인스턴서 | xml-ph-0000@deepl.internal XML의 Qt Quick 3DFileInstancing XML의 인스턴싱 테이블을 런타임에 직접 메모리 매핑이 가능한 바이너리 형식으로 변환합니다. |
번역 및 현지화
번역 파일을 추출, 변환 및 컴파일하기 위한 도구입니다.
| 도구 | 설명 |
|---|---|
| Qt Linguist | Qt의 번역 환경입니다. 번역가에게 소스 문자열을 검토하고, 번역을 입력하며, 릴리스 전에 .ts 파일을 검증할 수 있는 워크플로를 제공합니다. |
다음 도구는 Qt Linguist 의 일부입니다.
| 도구 | 설명 |
|---|---|
| lupdate | C++ 및 QML 소스 파일에서 번역 가능한 문자열을 추출하고, .ts 번역 파일을 생성하거나 업데이트합니다. |
| lupdate-pro | .pro 프로젝트 파일을 읽어 소스 파일의 위치를 파악하는 lupdate 의 변형 버전입니다. |
| lrelease | .ts 번역 파일을 런타임에서 사용할 수 있도록 .qm 바이너리 형식으로 컴파일합니다. |
| lrelease-pro | .pro 프로젝트 파일을 읽어들이는 lrelease 의 변형 버전입니다. |
| lconvert | 번역 파일 형식(TS, XLIFF, PO 등) 간 변환을 수행합니다. |
| ltext2id | 텍스트 기반 번역 파일을 ID 기반 형식으로 변환합니다. |
| lcheck | .ts 파일을 검증하고 일반적인 오류를 보고합니다. CI 파이프라인에서 사용하기에 적합합니다. |
테스트 및 진단
Qt 애플리케이션 테스트, D-Bus 서비스 검사 및 런타임 문제 진단을 위한 도구입니다. 자동화된 GUI 및 시스템 수준 테스트에 대해서는 Squish를 참조하십시오.
| 도구 | 설명 |
|---|---|
| Qt D-Bus 뷰어 | D-Bus 서비스를 위한 그래픽 브라우저입니다. 객체, 인터페이스 및 속성을 검사하고, 대화형으로 메서드를 호출할 수 있습니다. |
| qmlpreview | 연결된 장치나 호스트에서 QML 파일이 저장되는 즉시 애플리케이션을 재시작하지 않고도 파일을 핫 리로드합니다. |
| androidtestrunner | Android 기기나 에뮬레이터에서 Qt Test 자동 테스트를 실행하고 결과를 수집합니다. |
| qml 유틸리티 | 컴파일된 애플리케이션 래퍼 없이 QML 파일을 불러와 실행합니다. 신속한 프로토타이핑 및 개별 QML 컴포넌트 테스트에 유용합니다. |
프로파일링 및 추적
Qt 및 QML 애플리케이션의 런타임 성능 데이터를 수집하고 분석하기 위한 도구입니다.
| Tool | 설명 |
|---|---|
| qmlprofiler | 애플리케이션에서 QML 추적 데이터를 가져옵니다. 수집된 데이터는 Qt Creator 에서 시각화할 수 있습니다. |
배포 도구
대상 플랫폼에 배포하기 위해 Qt 애플리케이션을 패키징하는 도구입니다.
| 도구 | 설명 |
|---|---|
| androiddeployqt 도구 | 컴파일된 Qt 애플리케이션에서 배포 가능한 Android APK 또는 AAB를 생성하며, 필요한 Qt 라이브러리와 자산을 함께 묶어줍니다. |
| harmonydeployqt 도구 | 컴파일된 Qt 애플리케이션에서 배포 가능한 HarmonyOS Ability Package(HAP)를 생성하며, 필요한 Qt 라이브러리, 플러그인 및 QML 모듈을 번들링합니다. |
| macOS 배포 도구 | Qt 라이브러리를 비공개 프레임워크로 포함하는 배포 가능한 애플리케이션 번들을 생성하는 과정을 자동화합니다. |
| Windows 배포 도구 | 필요한 모든 Qt 라이브러리, 플러그인, QML 모듈 및 런타임 종속성을 즉시 실행 가능한 배포 폴더에 모아줍니다. |
Qt Application Manager
Qt Application Manager 는 애플리케이션의 수명 주기를 관리, 샌드박싱 및 제어하는 임베디드 시스템 UI를 구축하기 위한 프레임워크입니다.
| 도구 | 설명 |
|---|---|
| Qt Application Manager | 주요 애플리케이션 관리자 도구입니다. 임베디드 시스템 UI를 위한 합성 윈도우 관리자 및 애플리케이션 수명 주기 제어기 역할을 합니다. |
다음 명령줄 유틸리티는 Qt Application Manager 제품군의 일부입니다.
| 도구 | 설명 |
|---|---|
| 컨트롤러 (appman) | 실행 중인 appman 인스턴스를 원격으로 제어합니다: 애플리케이션 시작 및 중지, 패키지 설치, 런타임 상태 조회 등을 수행합니다. |
| 패키저(appman) | 애플리케이션 관리자가 설치할 수 있도록 애플리케이션 패키지를 생성, 서명 및 검증합니다. |
| 패키지 서버 (appman) | 무선 설치 테스트를 위해 애플리케이션 패키지를 배포하는 경량 개발용 HTTP 서버입니다. |
ActiveQt, Windows COM 통합
Windows에서 COM 및 ActiveX를 다루기 위한 도구: 타입 라이브러리에서 C++ 바인딩 생성, 문서 생성 및 ActiveX 컨트롤 테스트.
| 도구 | 설명 |
|---|---|
| dumpcpp | Windows COM 타입 라이브러리에서 C++ 네임스페이스 및 클래스 정의를 생성하여, Qt/C++ 코드로 COM 서버를 구동할 수 있게 합니다. |
| dumpdoc | 타입 라이브러리를 기반으로 COM 객체에 대한 HTML 문서를 생성합니다. |
| 인터페이스 설명 컴파일러(idc) | Qt 플러그인 DLL을 후처리하여 COM 서버로 등록하고, 필요한 IDL 및 타입 라이브러리 메타데이터를 생성합니다. |
| ActiveX 테스트 컨테이너(testcon) | ActiveX 컨트롤을 테스트하고 탐색하기 위한 대화형 컨테이너입니다. |
UI 디자인
시각 효과 및 애플리케이션 양식을 디자인하기 위한 도구입니다.
| 도구 | 설명 |
|---|---|
| Qt Quick Effect Maker | Qt Quick 항목에 대한 사용자 지정 프래그먼트 셰이더 효과를 디자인하고 미리 볼 수 있는 시각적 노드 기반 도구입니다. |
| Qt Widgets Designer | Qt Widgets 애플리케이션을 위한 WYSIWYG 양식 및 위젯 디자이너로, uic 에서 사용하는 .ui 파일을 생성합니다. |
문서화 도구
Qt 문서를 생성하고 탐색하기 위한 도구입니다.
| 도구 | 설명 |
|---|---|
| QDoc | Qt의 문서 생성기입니다. 주석이 달린 C++ 소스 코드와 .qdocconf 구성 파일을 읽어 들여 HTML 또는 Qt Help 형식의 출력을 생성합니다. |
| Qt Assistant | Qt의 오프라인 문서 브라우저입니다. 애플리케이션에 내장하여 상황에 맞는 도움말을 제공합니다. |
| qhelpgenerator | Qt Help 프로젝트(.qhp) 파일을 Qt Assistant 및 Qt Help 프레임워크에서 사용할 수 있는 압축된 .qch 아카이브로 컴파일합니다. |
© 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.
