qmake 실행
qmake를 실행할 때 명령줄에서 다양한 옵션을 지정하여 qmake의 동작을 사용자 정의할 수 있습니다. 이를 통해 빌드 과정을 세밀하게 조정하고, 유용한 진단 정보를 얻을 수 있으며, 프로젝트의 대상 플랫폼을 지정하는 데 사용할 수 있습니다.
명령어 구문
qmake를 실행하는 데 사용되는 구문은 다음과 같이 간단합니다.
qmake [mode] [options] files참고: 패키지 관리자를 통해 Qt를 설치한경우 , 바이너리 파일의 경로는 qmake6 일 수 있습니다.
작동 모드
qmake는 두 가지 작동 모드를 지원합니다. 기본 모드에서 qmake는 프로젝트 파일의 정보를 사용하여 Makefile을 생성하지만, qmake를 사용하여 프로젝트 파일을 생성할 수도 있습니다. 모드를 명시적으로 설정하려면 다른 모든 옵션보다 먼저 해당 모드를 지정해야 합니다. mode 는 다음 두 값 중 하나일 수 있습니다:
-makefile
qmake의 출력물은 Makefile이 됩니다.-project
qmake의 출력물은 프로젝트 파일이 됩니다.참고: 생성된 파일을 편집해야 할 가능성이높습니다 . 예를 들어, 프로젝트에 필요한 모듈에 맞게 `
QT` 변수를 추가해야 할 수 있습니다.
options 를 사용하여 일반 설정과 모드별 설정을 모두 지정할 수 있습니다. Makefile 모드에만 적용되는 옵션은 ‘Makefile 모드 옵션’ 섹션에 설명되어 있으며, 프로젝트 파일 생성에 영향을 미치는 옵션은 ‘프로젝트 모드 옵션’ 섹션에 설명되어 있습니다.
파일
files 인수는 공백으로 구분된 하나 이상의 프로젝트 파일 목록을 나타냅니다.
일반 옵션
빌드 프로세스를 사용자 정의하고 플랫폼의 기본 설정을 재정의하기 위해 qmake 명령줄에서 다양한 옵션을 지정할 수 있습니다. 다음의 기본 옵션은 qmake 사용법에 대한 도움말을 제공하고, qmake가 출력 파일을 기록할 위치를 지정하며, 콘솔에 기록될 디버깅 정보의 수준을 제어합니다:
-help
qmake는 이러한 기능들을 살펴보고 유용한 도움말을 제공합니다.-o file
qmake 출력은 로 전송됩니다. 이 옵션이 지정되지 않으면 qmake는 실행 중인 모드에 따라 출력에 적합한 파일 이름을 사용하려고 시도합니다. '-'가 지정되면 출력은 stdout으로 전송됩니다.file
-d
qmake는 디버깅 정보를 출력합니다. 를 두 번 이상 추가하면 출력 수준이 높아집니다.-d
프로젝트에 사용되는 템플릿은 일반적으로 프로젝트 파일의 TEMPLATE 변수로 지정됩니다. 다음 옵션을 사용하여 이를 재정의하거나 수정할 수 있습니다:
-t tmpl
qmake는 설정된 변수를 으로 재정의하지만, 이는 .pro 파일이 처리된TEMPLATEtmpl후에만 적용됩니다.-tp prefix
qmake는 를 변수에 추가합니다.prefixTEMPLATE
경고 정보의 수준을 미세 조정하여 프로젝트 파일의 문제점을 쉽게 찾을 수 있습니다:
-Wall
qmake는 알려진 모든 경고를 보고합니다.-Wnone
qmake는 어떠한 경고 정보도 생성하지 않습니다.-Wparser
qmake는 파서 경고만 생성합니다. 이를 통해 프로젝트 파일 파싱 시 흔히 발생하는 함정과 잠재적인 문제를 알 수 있습니다.-Wlogic
qmake는 프로젝트 파일의 일반적인 함정 및 잠재적 문제에 대해 경고합니다. 예를 들어, qmake는 목록에 파일이 중복되어 있거나 파일이 누락된 경우를 보고합니다.
Makefile 모드 옵션
qmake -makefile [options] filesMakefile 모드에서 qmake는 프로젝트 빌드에 사용되는 Makefile을 생성합니다. 또한, 이 모드에서는 다음 옵션을 사용하여 프로젝트 파일 생성 방식을 조정할 수 있습니다:
-after
qmake는 지정된 파일들 뒤에 명령줄에서 주어진 할당 사항을 처리합니다.-nocache
qmake는 ` ` 파일을 무시합니다..qmake.cache-nodepend
qmake는 의존성 정보를 생성하지 않습니다.-cache file
qmake는 를 캐시 파일로 사용하며, 발견된 다른 .qmake.cache 파일은 모두 무시합니다.file-spec spec
qmake는 를 플랫폼 및 컴파일러 정보의 경로로 사용하고,specQMAKESPEC의 값은 무시합니다.
명령줄에서 qmake 할당문을 전달할 수도 있습니다. 이 할당문들은 지정된 모든 파일보다 먼저 처리됩니다. 예를 들어, 다음 명령은 test.pro에서 Makefile을 생성합니다:
qmake -makefile -o Makefile "CONFIG+=test" test.pro그러나 지정된 옵션 중 일부는 기본값이므로 생략할 수 있습니다:
qmake "CONFIG+=test" test.pro변수 처리를 지정된 파일 처리 후에 수행하도록 확실히 원한다면, ` -after ` 옵션을 전달할 수 있습니다. 이 옵션이 지정되면, ` -after ` 옵션 뒤에 나오는 명령줄의 모든 할당 문은 지정된 파일이 파싱된 후로 미뤄집니다.
프로젝트 모드 옵션
qmake -project [options] files프로젝트 모드에서 qmake는 프로젝트 파일을 생성합니다. 또한 이 모드에서는 다음과 같은 옵션을 지정할 수 있습니다:
-r
qmake는 지정된 디렉터리를 재귀적으로 검색합니다.-nopwd
qmake는 현재 작업 디렉터리에서 소스 코드를 검색하지 않습니다. 지정된 만 사용합니다.files
이 모드에서 files 인수는 파일 또는 디렉터리의 목록일 수 있습니다. 디렉터리가 지정되면 DEPENDPATH 변수에 포함되며, 해당 디렉터리의 관련 코드가 생성된 프로젝트 파일에 포함됩니다. 파일이 지정되면 확장자에 따라 적절한 변수에 추가됩니다. 예를 들어, UI 파일은 FORMS에 추가되고, C++ 파일은 SOURCES에 추가됩니다.
이 모드에서는 명령줄을 통해 할당 사항을 전달할 수도 있습니다. 이 경우, 해당 할당 사항은 생성된 프로젝트 파일의 맨 끝에 배치됩니다.
© 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.