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 관련 변수에 대한 자세한 내용은 CMake 변수 참조를 참조하십시오.

멀티-컨피그 지원

Qt Creator 는 Xcode, Visual Studio 및 Ninja Multi-Config와 같은 멀티-컨피그 생성기를 지원합니다. 즉, CMake를 한 번만 구성하면 되고, 빌드 디렉터리가 하나만 필요하며, 빌드 유형 간에 더 빠르게 전환할 수 있습니다.

그러나 이는 Qt Creator 이 더 이상 첫 번째 CMake 파일 API JSON 내보내기를 단순히 파싱할 수 없다는 것을 의미합니다. 따라서 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 을 선택합니다.

기본적으로 모든 변수를 보려면 환경설정 > CMake > General 으로 이동하여 Show advanced options by default 을 선택합니다.

초기 변수로 재구성하기

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

Qt Creator 가 변경 사항을 재설정하기 전에 확인하려면 환경설정 > CMake > General 로 이동하여 Ask before re-configuring with initial parameters 을 선택합니다.

CMake 출력 보기

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

CMake에서 출력을 지우려면 (Clear)를 선택합니다.

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으로 설정해 보세요.

Windows에서 정션 포인트 사용

Windows에서 긴 경로 문제를 해결하려면 소스 및 빌드 디렉터리에 대한 정션 포인트를 생성하여 사용하세요. 정션 포인트에서 디렉터리는 컴퓨터의 다른 디렉터리에 대한 별칭 역할을 합니다.

CMake 구성, 빌드 및 설치 작업에 정션 포인트를 사용하려면 환경설정 > CMake > General 으로 이동하여 Use junctions for CMake configuration and build operations 을 선택합니다.

Qt Creator 정션 포인트를 C:\ProgramData\QtCreator\Links 에 저장합니다. 다른 경로를 사용하려면 QTC_CMAKE_JUNCTIONS_DIR 환경 변수의 값으로 설정합니다.

QTC_CMAKE_JUNCTIONS_HASH_LENGTH 환경 변수를 설정하여 MD5 해시 키 길이를 기본 길이 값인 32보다 짧게 설정합니다.

CMake 빌드 단계

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

Build Steps 에서 CMake 및 생성기에 전달할 인수와 빌드 명령의 대상을 추가할 수 있습니다.

크로스 컴파일 시 스테이징 디렉터리에 애플리케이션을 설치하려면 Stage for installation 을 선택하고 Staging directory 필드에 디렉터리 경로를 지정합니다. 패키징 도구는 디렉터리의 내용에서 패키지를 구성합니다.

Ninja를 CMake 생성기로 사용

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

1. Ninja를 설치합니다.
2. PATH 시스템 변수의 값에 Ninja 실행 파일의 경로를 추가합니다.
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. 환경설정 > CMake > General 로 이동하여 Package manager auto setup 을 선택합니다.

QTC_RUN 환경 변수

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

이렇게 하면 CMake 코드가 Qt Creator 에서 실행되는지 감지할 수 있습니다.

CMake 클린 단계

CMake로 빌드할 때 CMake와 생성기에 전달할 인수를 추가하고 Clean Steps 에서 clean 명령의 대상을 지정할 수 있습니다.

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