개요
qmake 도구는 애플리케이션, 라이브러리 및 기타 구성 요소의 빌드 프로세스를 관리하기 위한 프로젝트 중심 시스템을 제공합니다. 이 접근 방식을 통해 사용된 소스 파일을 제어할 수 있으며, 일반적으로 단일 파일 내에서 프로세스의 각 단계를 간결하게 설명할 수 있습니다. qmake는 각 프로젝트 파일의 정보를 컴파일 및 링크에 필요한 명령을 실행하는 Makefile로 확장합니다.
프로젝트 설명
프로젝트는 프로젝트(.pro) 파일의 내용으로 기술됩니다. qmake는 파일 내의 정보를 사용하여 각 프로젝트를 빌드하는 데 필요한 모든 명령이 포함된 Makefile을 생성합니다. 프로젝트 파일에는 일반적으로 소스 파일 및 헤더 파일 목록, 일반적인 구성 정보, 그리고 링크할 추가 라이브러리 목록이나 사용할 추가 포함 경로 목록과 같은 애플리케이션별 세부 사항이 포함됩니다.
프로젝트 파일에는 주석, 변수 선언, 내장 함수, 간단한 제어 구조 등 다양한 요소가 포함될 수 있습니다. 대부분의 간단한 프로젝트에서는 프로젝트를 빌드하는 데 사용되는 소스 및 헤더 파일을 몇 가지 기본 구성 옵션과 함께 선언하기만 하면 됩니다. 간단한 프로젝트 파일을 만드는 방법에 대한 자세한 내용은 qmake 시작하기를 참조하십시오.
복잡한 프로젝트의 경우 더 정교한 프로젝트 파일을 생성할 수 있습니다. 프로젝트 파일에 대한 개요는 ‘프로젝트 파일 생성’을 참조하십시오. 프로젝트 파일에서 사용할 수 있는 변수 및 함수에 대한 자세한 내용은 ‘참조’를 참조하십시오.
애플리케이션 또는 라이브러리 프로젝트 템플릿을 사용하여 특화된 구성 옵션을 지정함으로써 빌드 프로세스를 세밀하게 조정할 수 있습니다. 자세한 내용은 ‘일반적인 프로젝트 유형 빌드’를 참조하십시오.
Qt Creator 의 새 프로젝트 마법사를 사용하여 프로젝트 파일을 생성할 수 있습니다. 프로젝트 템플릿을 선택하면, Qt Creator 에서 프로젝트를 빌드하고 실행할 수 있도록 기본값이 설정된 프로젝트 파일을 생성합니다. 용도에 맞게 프로젝트 파일을 수정할 수 있습니다.
qmake를 사용하여 프로젝트 파일을 생성할 수도 있습니다. qmake 명령줄 옵션에 대한 자세한 설명은 ‘qmake 실행’을 참조하십시오.
qmake의 기본 구성 기능만으로도 대부분의 크로스 플랫폼 프로젝트를 처리할 수 있습니다. 그러나 플랫폼별 변수를 사용하는 것이 유용하거나 심지어 필수적일 수도 있습니다. 자세한 내용은 ‘플랫폼 관련 참고 사항’을 참조하십시오.
프로젝트 빌드
간단한 프로젝트의 경우, 프로젝트의 최상위 디렉터리에서 qmake를 실행하기만 하면 Makefile이 생성됩니다. 그런 다음 해당 플랫폼의 make 도구를 실행하여 Makefile에 따라 프로젝트를 빌드할 수 있습니다.
qmake가 빌드 프로세스를 구성할 때 사용하는 환경 변수에 대한 자세한 내용은 qmake 구성을 참조하십시오.
참고: 시스템에서 실행되는 모든 바이러스 백신 프로그램의 제외 디렉터리 목록에 프로젝트 빌드 디렉터리를추가하십시오 .
타사 라이브러리 추가
'타사 라이브러리 사용' 가이드에서는 Qt 프로젝트에서 간단한 타사 라이브러리를 사용하는 방법을 설명합니다.
헤더 사전 컴파일
대규모 프로젝트에서는 사전 컴파일된 헤더 파일을 활용하여 빌드 프로세스의 속도를 높일 수 있습니다. 자세한 내용은 ‘사전 컴파일된 헤더 사용’을 참조하십시오.
© 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.