CMake를 사용하여 프로젝트 빌드하기

방법: CMake를 사용하여 빌드하기

선택한 키트의 빌드 설정을 지정하려면 ‘ Projects ’ > ‘ Build Settings ’로 이동하십시오.

Qt Creator 에서 중대형 규모의 CMake 프로젝트를 구성하는 것은 프로젝트를 올바르게 구성하기 위해 CMake에 전달해야 하는 변수의 수가 많기 때문에 어려울 수 있습니다. 이 과정을 더 쉽게 하기 위해, Qt Creator 는 키트 기본 설정에 따라 초기 구성을 생성하고, 이를 프로젝트의 Build Settings 내 Initial Configuration 에 표시합니다. 또는 CMake 사전 설정을 사용하여 CMake를 구성할 수도 있습니다.

‘ Configure ’ 필드에는 ‘ Build directory ’ 및 ‘ Build type ’ 필드의 값을 사용하여 Qt Creator 가 생성한 실제 CMake 호출 내용이 표시됩니다.

` Additional CMake options`에서 ` --find-debug`, ` --trace-expand` 또는 ` --warn-uninitialized`과 같은 추가 CMake 옵션을 지정할 수 있습니다. 옵션에 대한 자세한 내용은 필드 이름의 링크를 선택하거나 CMake: cmake(1)을 참조하십시오.

Kit Configuration 를 선택하면 프로젝트에 선택된 빌드 및 실행 키트의 CMake 설정을 편집할 수 있습니다.

CMake 사전 설정 파일을 사용하여 일반적인 구성, 빌드 및 테스트 옵션을 지정하고 다른 사용자와 공유할 수 있습니다.

초기 구성

Initial Configuration 목록은 ‘ Qt Creator ’가 CMake 프로젝트를 처음 구성할 때 사용하는 변수들을 나열합니다. 이 목록에서는 키트의 CMake 구성에서 가져온 기본값을 기울임꼴로 표시합니다. ‘ Qt Creator ’는 변수의 초기 구성 목록을 프로젝트 소스 디렉터리 아래의 .qtcreator 디렉터리에 있는 CMakeLists.txt.user 파일에 저장합니다.

현재 구성

Current Configuration 는 .cmake/api/v1/reply 디렉터리에 있는 cmake-file-api JSON 내보내기 파일의 CMake 변수 목록을 표시합니다. 초기 구성에서 파생된 변수는 이탤릭체로, 일치하지 않는 값은 빨간색으로 표시됩니다.

Run CMake 버튼을 선택한 후에는 Qt Creator 에서 CMake로 전달하는 변수의 실제 값을 확인하고 변경할 수 있습니다. ‘ Key ’ 열에는 변수 이름이, ‘ Value ’ 열에는 해당 변수의 현재 값이 나열됩니다. 변수에 대한 자세한 내용은 컨텍스트 메뉴에서 ‘ Help ’를 선택하거나 CMake: cmake-variables(7)을 참조하십시오. Qt XML 전용 변수에 대한 자세한 내용은 CMake 변수 참조를 참조하십시오.

다중 구성 지원

Qt Creator Xcode, Visual Studio, Ninja Multi-Config와 같은 다중 구성(Multi-config) 생성기를 지원합니다. 즉, CMake를 한 번만 구성하고 빌드 디렉터리를 하나만 유지하면 되며, 빌드 유형 간 전환을 더 빠르게 수행할 수 있습니다.

그러나 이는 Qt Creator 가 더 이상 첫 번째 CMake 파일 API JSON 내보내기만 단순히 파싱할 수 없음을 의미하기도 합니다. 따라서 단일 구성 생성기(Ninja, Makefile)가 사용할 생성기를 결정하려면 Build type 필드의 값이 CMAKE_BUILD_TYPE 변수의 값과 일치해야 합니다.

iOS용 Qt 6으로 개발할 때는 Xcode 생성기만 지원됩니다.

변수 값 수정

Initial Configuration 또는 Current Configuration 에서 CMake로 전달되는 변수의 실제 값을 확인하고 편집할 수 있습니다.

여러 변수를 선택하여 해당 변수들에 대해 작업을 적용할 수 있습니다. 선택을 해제하려면 뷰의 아무 곳이나 클릭하십시오.

변수 값을 일괄 편집하려면 Batch Edit 를 선택하십시오.

현재 구성으로 빌드하려면 Run CMake 를 선택하십시오. 빌드 중에는 버튼 텍스트가 Stop CMake 로 변경됩니다. 현재 빌드를 취소하려면 이 버튼을 선택하십시오.

변수 추가

변수를 추가하려면 ‘ Add ’을 선택한 다음, 추가할 변수의 유형( Boolean, String, Directory 또는 File)을 선택하십시오.

선택한 변수의 유형을 변경하려면 ‘ Key ’ 열에서 변수 이름을 마우스 오른쪽 버튼으로 클릭한 다음, 컨텍스트 메뉴에서 ‘ Force to bool ’, ‘ Force to file ’, ‘ Force to directory ’ 또는 ‘ Force to string ’을 선택합니다.

선택한 변수의 이름이나 값을 클립보드에 복사하려면 컨텍스트 메뉴에서 ‘ Copy ’을 선택하십시오.

변수 값 변경

변수의 값을 변경하려면 변수를 두 번 클릭하거나 선택한 다음, ‘ Edit ’을 선택하십시오. 초기, 현재 및 키트 구성이 동기화되지 않은 경우, ‘ Initial Configuration ’ 또는 ‘ Current Configuration ’에서 컨텍스트 메뉴의 ‘ Apply Kit Value ’ 또는 ‘ Apply Initial Configuration Value ’을 선택하십시오.

사용자가 적용한 모든 변경 사항을 초기화하려면 ‘ Reset ’를 선택하십시오.

변경한 변수 값은 -D<option>=<value> 를 통해 CMake로 전달되며, CMake는 해당 옵션을 CMakeCache.txt 파일에 저장합니다. 즉, 빌드 디렉터리를 삭제하면 초기 CMake 구성에 포함되지 않은 모든 사용자 정의 변수도 함께 삭제됩니다.

변경된 변수 값을 사용하여 프로젝트를 재구성하려면, ‘ Build ’로 이동하여 ‘ Clear CMake Configuration ’를 선택하십시오. 그러면 ‘ CMakeCache.txt ’ 파일이 삭제됩니다. 이를 통해 전체 재빌드를 수행할 수 있습니다.

변수 제거

선택한 변수를 제거하려면 ‘ Unset ’를 선택하십시오. 제거를 취소하려면 ‘ Set ’를 선택하십시오.

고급 변수 보기

모든 변수를 보려면 ‘ Advanced ’를 선택하십시오.

기본적으로 모든 변수를 보려면 ‘ Preferences ’ > ‘ CMake ’ > ‘ General ’로 이동한 후 ‘ Show advanced options by default ’를 선택하십시오.

초기 변수를 사용하여 재구성하기

CMake 변수를 초기값으로 재설정하려면 Initial Configuration 에서 Re-configure with Initial Variables 를 선택하십시오. Qt Creator 는 현재 CMake 구성을 삭제하고 CMake를 실행합니다. 초기 구성 값은 CMakeLists.txt.user 파일에 저장되므로, 빌드 디렉터리를 삭제해도 초기 구성은 삭제되지 않습니다.

Qt Creator 가 변경 사항을 재설정하기 전에 확인 메시지를 표시하도록 하려면, Preferences > CMake > General 로 이동하여 ‘ Ask before re-configuring with initial parameters ’를 선택하십시오.

CMake 출력 확인

CMake의 출력은 Projects 모드에서 Build Settings, Deploy Settings 및 Run Settings 탭 옆에 표시됩니다.

CMake 출력을 지우려면 ‘ ’(Clear)를 선택하십시오.

CMake를 실행할 때마다 이전 출력을 항상 지우려면, ‘ Preferences ’ > ‘ CMake ’ > ‘ General ’로 이동하여 ‘ Clear old CMake output on a new run ’를 선택하십시오.

Filter 필드에 문자열을 입력하여 출력을 필터링할 수 있습니다. 필터링 옵션을 지정하려면 을 선택하십시오. 정규 표현식이나 대소문자 구분을 사용하여 출력을 필터링할 수 있습니다. Show Non-matching Lines 을 선택하면 필터 조건에 맞는 줄을 숨길 수 있습니다. 또한 표시할 앞뒤 줄의 수를 설정할 수도 있습니다.

Ctrl+F를 선택하여 출력에서 문자열을 검색할 수 있습니다.

출력 텍스트 크기를 늘리거나 줄이려면 ‘ ’(Zoom In), Ctrl++, ‘ ’(Zoom Out) 또는 Ctrl+-를 선택하십시오 .

출력을 숨기려면 (Hide Right Sidebar) 또는 Alt+Shift+0을 선택하십시오.

CLICOLOR_FORCE 환경 변수

Qt Creator CLICOLOR_FORCE 환경 변수를 1로 설정하면 CMake에 대해 ANSI 색상 출력이 표시됩니다. 이는 프로세스 출력에 영향을 줄 수 있습니다.

출력이 올바르지 않거나 이전 버전의 Qt Creator 와 다르게 보인다면, Use Build Environment 에서 CLICOLOR_FORCE 를 0으로 설정해 보십시오.

CMake 빌드 단계

Qt Creator cmake . --build 를 실행하여 CMake 프로젝트를 빌드하며, 이때 프로젝트 구성에 지정된 CMake 생성기(예: , , 또는 )가 실행됩니다. CMake 생성기는 에 대한 프로젝트 파일을 생성합니다. 다중 구성 생성기도 지원됩니다. make mingw32-make nmake ninja Qt Creator

Build Steps 에서 CMake 및 생성기에 전달할 인자와 빌드 명령을 위한 타깃을 추가할 수 있습니다.

애플리케이션을 스테이징 디렉터리에 설치하려면 Install into staging directory 를 선택하고 스테이징 디렉터리의 경로를 지정하십시오. 이 옵션을 사용하면 DESTDIR 가 지정된 디렉터리로 설정된 상태에서 CMake의 install 타깃이 실행됩니다. 배포 구성에 대한 타깃 위치는 영향을 받지 않습니다. 예를 들어, 원격 대상 장치를 위해 개발하고 빌드 장치의 시스템 디렉터리에 설치하지 않으려는 경우, 또는 서로 다른 빌드 구성을 위해 빌드 장치에서 별도의 설치 디렉터리를 사용하려는 경우에 이 옵션을 사용하십시오.

CMake 생성기로 Ninja 사용하기

CMake에서 Ninja를 사용하려면 Ninja를 설치하고 빌드 및 실행 키트에서 CMake 생성기로 선택해야 합니다:

1. Ninja를 설치합니다.
2. Ninja 실행 파일의 경로를 PATH 시스템 변수의 값에 추가합니다.
3. Projects > Build Settings 로 이동하여 ‘ Kit Configuration ’를 선택합니다.

   

4. ' CMake generator ' 필드 옆에 있는 ' Change '을 선택하여 ' CMake Generator ' 대화 상자를 엽니다.

   

5. ' Generator'에서 ' Ninja'을 선택합니다.
6. OK 를 선택하여 변경 사항을 저장하고 대화 상자를 닫습니다.
7. Close 를 선택하여 Kit CMake Configuration 대화 상자를 닫고 Build Settings 로 돌아갑니다.

패키지 관리자와 함께 CMake 사용하기

CMake와 함께 사용할 수 있도록 Conan 또는 vcpkg 패키지 관리자를 자동으로 설정하려면:

1. 프로젝트 소스 디렉터리에 있는 conanfile.txt, conanfile.py 또는 vcpkg.json 파일에서 종속성을 설치하는 CMake 스크립트 파일을 생성합니다.
2. CMAKE_PROJECT_INCLUDE_BEFORE 변수의 값으로 해당 스크립트의 경로를 설정합니다.
3. Preferences > CMake > General 로 이동하여 ‘ Package manager auto setup ’를 선택합니다.

QTC_RUN 환경 변수

Qt Creator 는 cmake 프로세스를 실행할 때 QTC_RUN 환경 변수를 1 로 설정합니다.

이를 통해 CMake 코드가 Qt Creator 에서 실행되고 있는지 감지할 수 있습니다.

CMake clean 단계

CMake로 빌드할 때, Clean Steps 의 clean 명령어에 전달할 인자와 생성기 및 대상을 추가할 수 있습니다.

빌드 오류 및 경고는 분석되어 이슈에 표시됩니다.