명령줄에서 프로젝트 빌드하기

이 페이지에서는 기존 프로젝트를 구성하고 빌드하는 방법을 설명합니다. Qt 기반 CMake 프로젝트를 생성하는 방법을 알고 싶다면, CMake 시작하기 문서를 참조하십시오.

Qt 프로젝트를 빌드하려면 CMake가 Qt가 설치된 위치를 알아야 합니다. 일반적으로 이는 CMake 변수 CMAKE_PREFIX_PATH를 Qt의 설치 접두사로 설정하여 수행합니다. 크로스 컴파일을 하는 경우, 설정해야 할 추가 변수에 대한 자세한 내용은 크로스 컴파일 항목을 참조하십시오.

Qt Online Installer 를 사용하여 Qt를 설치한 경우, 최상위 설치 디렉터리 내에서 Qt 버전을 선택하십시오. 예를 들어, 다음 명령어는 Windows에서 이를 수행하는 방법을 보여줍니다:

cmake -DCMAKE_PREFIX_PATH=C:\Qt\6.12.0\msvc2022_64 -S <source-dir> -B <build-dir>

<source-dir> 및 <build-dir> 자리 표시자는 프로젝트의 소스 디렉터리와 빌드 디렉터리를 나타냅니다.

CMake 생성기

CMake는 GNU Make나 Ninja와 같은 빌드 도구가 프로젝트를 빌드할 수 있도록 필요한 빌드 시스템 파일을 생성합니다.

CMake의 기본 생성기는 플랫폼과 빌드 환경에 따라 달라집니다. 예를 들어, Windows에서 Visual Studio 환경이 감지되면 CMake는 Visual Studio 프로젝트 파일을 생성합니다.

모든 플랫폼에서 일관된 개발자 경험을 얻으려면 Ninja 또는 Ninja Multi-Config 생성기를 사용하십시오.

CMAKE_GENERATOR 환경 변수를 설정하거나 -G 인수를 사용하여 CMake 생성기를 선택할 수 있습니다.

cmake -G Ninja ...

qt-cmake

qt-cmake 스크립트는 프로젝트를 구성하는 데 유용한 대안입니다. 이 스크립트를 사용하면 CMAKE_PREFIX_PATH 를 직접 지정할 필요가 없습니다. 이 스크립트는 Qt 설치 경로의 bin 디렉터리에 있습니다. 이 스크립트는 모든 매개변수를 CMake로 전달하므로, cmake 를 사용하는 것과 똑같이 사용할 수 있습니다:

C:\Qt\6.12.0\msvc2022_64\bin\qt-cmake -G Ninja -S <source-dir> -B <build-dir>

빌드 시스템 파일이 생성되면 프로젝트를 빌드할 준비가 완료됩니다:

cd <build-dir>
ninja

생성기에 구애받지 않는 CMake 명령을 사용할 수도 있습니다:

cmake --build <build-dir>

크로스 컴파일

개발용 컴퓨터와 다른 플랫폼을 위해 프로젝트를 빌드하는 것을 크로스 컴파일이라고 합니다. 예를 들어, Windows 컴퓨터(호스트 플랫폼)에서 Android(대상 플랫폼)용으로 빌드하는 경우가 있습니다.

CMake를 사용한 크로스 컴파일에는 대부분의 플랫폼에서 툴체인 파일이 필요합니다. 또한 대상 플랫폼용 Qt 버전 외에도 개발 호스트용 Qt 버전도 필요합니다. 예를 들어, Windows에서 Android용으로 크로스 컴파일하려면 Windows용 Qt와 Android용 Qt가 모두 설치되어 있어야 합니다.

대상 플랫폼용 Qt 설치 디렉터리에 있는 ` qt-cmake `를 사용하여 해당 플랫폼용 프로젝트를 크로스 컴파일하십시오:

<target-qt>/bin/qt-cmake -S <source-dir> -B <build-dir>

이렇게 하면 프로젝트가 대상 플랫폼에 맞게 구성됩니다. 툴체인 파일이 자동으로 전달되며, 경우에 따라 다른 플랫폼별 변수도 설정됩니다.

사용자 정의 툴체인 파일 지정

qt-cmake 스크립트는 Qt 내부 툴체인 파일을 CMake에 전달합니다. 이 툴체인 파일은 Qt의 대상 플랫폼에 특화된 여러 변수를 설정합니다.

사용 중인 Qt 설치본이 해당 컴퓨터에서 빌드된 것이 아닌 경우, ` qt-cmake `는 대상 플랫폼용 CMake 툴체인 파일의 위치를 알아야 합니다.

이 경우, ` QT_CHAINLOAD_TOOLCHAIN_FILE ` 변수를 설정하여 qt-cmake 가 사용자 정의 툴체인 파일을 체인 로드하도록 지시할 수 있습니다:

~/Qt/6.12.0/android_armv7/bin/qt-cmake -DQT_CHAINLOAD_TOOLCHAIN_FILE=<file-path> -S <source-dir> -B <build-dir>

이렇게 하면 Qt의 내부 툴체인 파일이 사용자 정의 툴체인 파일도 함께 로드하도록 지시됩니다.