qmake 실행하기

명령줄에서 다양한 옵션을 지정하여 qmake를 실행할 때 동작을 사용자 지정할 수 있습니다. 이를 통해 빌드 프로세스를 미세 조정할 수 있고 유용한 진단 정보를 제공하며 프로젝트의 대상 플랫폼을 지정하는 데 사용할 수 있습니다.

명령 구문

qmake를 실행하는 데 사용되는 구문은 다음과 같은 간단한 형식입니다:

qmake [mode] [options] files

작동 모드

qmake는 두 가지 작동 모드를 지원합니다. 기본 모드에서 qmake는 프로젝트 파일의 정보를 사용하여 메이크파일을 생성하지만, 프로젝트 파일을 생성하는 데 qmake를 사용할 수도 있습니다. 명시적으로 모드를 설정하려면 다른 모든 옵션보다 먼저 지정해야 합니다. mode 는 다음 두 가지 값 중 하나를 사용할 수 있습니다:

• -makefile
  qmake 출력은 메이크파일이 됩니다.
• -project
  qmake 출력은 프로젝트 파일이 됩니다.
  

  참고: 생성된 파일을 편집해야 할 가능성이 높습니다. 예를 들어 프로젝트에 필요한 모듈에 맞게 QT 변수를 추가할 수 있습니다.

options 을 사용하여 일반 설정과 모드별 설정을 모두 지정할 수 있습니다. 메이크파일 모드에만 적용되는 옵션은 메이크파일 모드 옵션 섹션에 설명되어 있고, 프로젝트 파일 생성에 영향을 주는 옵션은 프로젝트 모드 옵션 섹션에 설명되어 있습니다.

파일

files 인수는 공백으로 구분된 하나 이상의 프로젝트 파일 목록을 나타냅니다.

일반 옵션

빌드 프로세스를 사용자 지정하고 플랫폼의 기본 설정을 재정의하기 위해 명령줄에서 다양한 옵션을 qmake에 지정할 수 있습니다. 다음의 기본 옵션은 qmake 사용에 대한 도움말을 제공하고, qmake가 출력 파일을 쓰는 위치를 지정하고, 콘솔에 기록되는 디버깅 정보의 수준을 제어합니다:

• -help
  qmake는 이러한 기능을 살펴보고 몇 가지 유용한 도움말을 제공합니다.
• -o file
file 이 옵션을 지정하지 않으면 qmake는 실행 중인 모드에 따라 출력에 적합한 파일 이름을 사용하려고 시도합니다.
  '-'를 지정하면, 출력은 stdout으로 출력된다.
• -d
  qmake는 디버깅 정보를 출력합니다. -d 을 두 번 이상 추가하면 상세도가 높아집니다.

프로젝트에 사용되는 템플릿은 일반적으로 프로젝트 파일의 TEMPLATE 변수에 의해 지정됩니다. 다음 옵션을 사용하여 이 변수를 재정의하거나 수정할 수 있습니다:

• -t tmpl
  qmake는 tmpl 으로 설정된 TEMPLATE 변수를 재정의하지만 .pro 파일이 처리된 후에만 재정의합니다.
• -tp prefix
  qmake는 TEMPLATE 변수에 prefix 을 추가합니다.

프로젝트 파일에서 문제를 찾는 데 도움이 되도록 경고 정보의 수준을 미세 조정할 수 있습니다:

• -Wall
  qmake는 알려진 모든 경고를 보고합니다.
• -Wnone
  qmake는 경고 정보를 생성하지 않습니다.
• -Wparser
  qmake는 파서 경고만 생성합니다. 이는 프로젝트 파일 구문 분석의 일반적인 함정과 잠재적 문제를 알려줍니다.
• -Wlogic
  qmake는 프로젝트 파일의 일반적인 함정과 잠재적 문제를 경고합니다. 예를 들어, 목록에 파일이 여러 개 있는 경우와 누락된 파일이 있는 경우 qmake가 보고합니다.

메이크파일 모드 옵션

qmake -makefile [options] files

메이크파일 모드에서 qmake는 프로젝트를 빌드하는 데 사용되는 메이크파일을 생성합니다. 또한 이 모드에서 다음 옵션을 사용하여 프로젝트 파일 생성 방식에 영향을 줄 수 있습니다:

• -after
  qmake는 지정된 파일 뒤에 명령줄에 지정된 할당을 처리합니다.
• -nocache
  qmake는 .qmake.cache 파일을 무시합니다.
• -nodepend
  qmake는 종속성 정보를 생성하지 않습니다.
• -cache file
  qmake는 file 을 캐시 파일로 사용하고 다른 .qmake.cache 파일은 무시합니다.
• -spec spec
  qmake는 spec 를 플랫폼 및 컴파일러 정보의 경로로 사용하고 QMAKESPEC의 값을 무시합니다.

명령줄에서 qmake 할당을 전달할 수도 있습니다. 지정한 모든 파일보다 먼저 처리됩니다. 예를 들어 다음 명령은 test.pro에서 메이크파일을 생성합니다:

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에 추가됩니다.

이 모드에서는 명령줄에서 할당을 전달할 수도 있습니다. 이렇게 하면 이러한 할당은 생성된 프로젝트 파일에서 가장 마지막에 배치됩니다.