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

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

Qt 프로젝트를 빌드하려면 CMake가 Qt 설치 위치를 알아야 합니다. 보통 이 작업은 CMake 변수 CMAKE_PREFIX_PATH를 Qt의 설치 접두사로 설정하여 수행합니다. 교차 컴파일하는 경우 설정해야 할 추가 변수에 대한 자세한 내용은 교차 컴파일을 참조하십시오.

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

cmake -DCMAKE_PREFIX_PATH=C:\Qt\6.8.2\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.8.2\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.8.2/android_armv7/bin/qt-cmake -DQT_CHAINLOAD_TOOLCHAIN_FILE=<file-path> -S <source-dir> -B <build-dir>

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