CMake 프리셋

CMakePresets.json 에는 프로젝트 전체 빌드에 대한 옵션이 있는 반면, CMakeUserPresets.json 에는 로컬 빌드에 대한 옵션이 있습니다.

cmake-presets(7) 에 설명된 형식으로 프리셋 파일을 생성하고 프로젝트의 루트 디렉터리에 저장합니다. 그런 다음 프로젝트 보기에서 볼 수 있습니다.

Qt Creator 는 버전 5(CMake 3.24에 도입)까지의 프리셋 구성, 빌드 및 테스트를 지원하지만 버전 확인을 강제하지는 않습니다. 버전 5에 있는 경우 버전 5의 모든 필드를 읽고 사용합니다.

CMakeLists.txt.user 파일이 없거나 프로젝트의 모든 키트를 비활성화한 경우 프로젝트를 처음 열 때 프리셋을 가져올 수 있습니다.

CMake 프리셋이 있는 프로젝트 열기

Initial Configuration 필드와 그 아래의 환경 구성 필드에서 사전 설정을 볼 수 있습니다.

C메이크 환경 구성

CMakePresets.json 파일의 변경 사항을 업데이트하려면 Build 으로 이동하여 Reload CMake Presets 을 선택한 다음 로드할 사전 설정 파일을 선택합니다.

사전 설정 구성하기

다음 구성 사전 설정은 CMake가 플랫폼에서 기본 생성기를 사용하고 모든 빌드 유형에 대한 빌드 디렉터리를 지정하도록 지시합니다. NOT_COMMON_VALUE 환경 구성 필드의 Initial Parameters 및 AN_ENVIRONMENT_FLAG 에 표시됩니다.

{
  "version": 1,
  "configurePresets": [
    {
      "name": "preset",
      "displayName": "preset",
      "binaryDir": "${sourceDir}/build/preset",
      "cacheVariables": {
        "NOT_COMMON_VALUE": "NOT_COMMON_VALUE"
        },
      "environment": {
        "AN_ENVIRONMENT_FLAG": "1"
        }
      },
      "vendor": {
        "qt.io/QtCreator/1.0": {
           "AskBeforePresetsReload": false,
           "AskReConfigureInitialParams": false,
           "AutorunCMake": false,
           "PackageManagerAutoSetup": false,
           "ShowAdvancedOptionsByDefault": true,
           "ShowSourceSubFolders": false,
           "UseJunctionsForSourceAndBuildDirectories": true
           }
      }
  ]
}

vendor 섹션의 CMake 프로젝트 설정에 대한 자세한 내용은 CMake Qt 공급업체 프리셋을 참조하십시오.

MinGW 예제

다음 예제는 Qt 프로젝트를 구성합니다:

MinGW 컴파일러
빌드 디렉토리 - <sourceDir>/build-release
빌드 유형 - CMAKE_BUILD_TYPE as Release
생성기 - MinGW 메이크파일
CMake 실행 파일의 경로
경로를 통한 Qt 설치 경로 CMAKE_PREFIX_PATH
MinGW 11.2.0 64비트 디버거용 GNU gdb 11.2.0

{
  "version": 1,
  "configurePresets": [
    {
      "name": "mingw",
      "displayName": "MinGW 11.2.0",
      "generator": "MinGW Makefiles",
      "binaryDir": "${sourceDir}/build-release",
      "cmakeExecutable": "C:/Qt/Tools/CMake_64/bin/cmake.exe",
      "cacheVariables": {
        "CMAKE_BUILD_TYPE": "Release",
        "CMAKE_PREFIX_PATH": "C:/Qt/6.4.0/mingw_64"
      },
      "environment": {
        "PATH": "C:/Qt/Tools/mingw1120_64/bin;$penv{PATH}"
      },
      "vendor": {
        "qt.io/QtCreator/1.0": {
          "debugger": {
            "DisplayName": "GNU gdb 11.2.0 for MinGW 11.2.0 64-bit",
            "Abis": ["x86-windows-msys-pe-64bit"],
            "Binary": "C:/Qt/Tools/mingw1120_64/bin/gdb.exe",
            "EngineType": 1,
            "Version": "11.2.0"
          }
        }
      }
  ]
}

Windows에서 프로세스 속도를 높이려면 cacheVariables 섹션에서 CMAKE_C_COMPILER 및 CMAKE_CXX_COMPILER 을 지정합니다.

debugger 환경 설정 중 일부의 가능한 값은 CMake Qt 공급업체 프리셋을 참조하십시오.

닌자 생성기 예제

다음 구성 및 빌드 프리셋은 Ninja Multi-Config를 생성기로 설정하고 Debug 및 Release 빌드 단계를 추가하며 ninja.exe 경로를 CMAKE_MAKE_PROGRAM 변수의 값으로 지정합니다:

{
  "version": 2,
  "configurePresets": [
    {
      "name": "ninja-nmc",
      "displayName": "Ninja Multi-Config MinGW",
      "generator": "Ninja Multi-Config",
      "binaryDir": "${sourceDir}/build",
      "cacheVariables": {
        "CMAKE_CONFIGURATION_TYPES": "Debug;Release",
        "CMAKE_PREFIX_PATH": "C:/Qt/6.4.0/mingw_64",
        "CMAKE_MAKE_PROGRAM": "C:/Qt/Tools/Ninja/ninja.exe"
      },
      "environment": {
        "PATH": "c:/Qt/Tools/mingw1120_64/bin;$penv{PATH}"
      }
    }
  ],
  "buildPresets": [
    {
      "name": "release",
      "displayName": "Ninja Release",
      "configurePreset": "ninja-nmc",
      "configuration": "Release"
    },
    {
      "name": "debug",
      "displayName": "Ninja Debug",
      "configurePreset": "ninja-nmc",
      "configuration": "Debug"
    }
  ]
}

이 예제에서는 CMake 실행 경로가 환경설정 > CMake > Tools 에 설정되어 있다고 가정합니다.

MSVC 예제

NMAKE 메이크파일, Ninja 또는 Ninja 멀티 구성 생성기와 함께 MSVC 컴파일러를 사용하는 경우 architecture 및 toolset 필드에 external 전략을 사용할 수 있습니다. 이렇게 하면 Qt Creator 에서 CMake를 호출하기 전에 Visual C++ 환경을 설정할 수 있습니다.

예를 들어

"generator": "Ninja Multi-Config",
"toolset": {
  "value": "v142,host=x64",
  "strategy": "external"
},
"architecture": {
  "value": "x64",
  "strategy": "external"
},

MSVC 컴파일러를 비-VS 제너레이터와 함께 사용하고 PATH 에 여러 컴파일러가 있는 경우 cacheVariables 또는 environmentVariables 에서 사용할 컴파일러를 지정해야 할 수도 있습니다:

"generator": "Ninja Multi-Config",
"toolset": {
  "value": "v142,host=x64",
  "strategy": "external"
},
"architecture": {
  "value": "x64",
  "strategy": "external"
},
"cacheVariables": {
  "CMAKE_C_COMPILER": "cl.exe",
  "CMAKE_CXX_COMPILER": "cl.exe"
}

교차 컴파일 예제

다음 예제는 Windows용 macOS에서 교차 컴파일하고 macOS에서 wine 에뮬레이터로 실행하기 위한 Qt 프로젝트를 구성하는 예제입니다:

생성기 - 닌자
빌드 디렉토리 - <sourceDir>/build-release
LLVM/MinGW 툴체인
구성 유형 - CMAKE_BUILD_TYPE as Release
LLDB 18.1.6 디버거
wine 에뮬레이터

{
  "version": 4,
  "configurePresets": [
    {
      "name": "llvm-mingw",
      "displayName": "LLVM-MinGW 18.1.6",
      "generator": "Ninja",
      "binaryDir": "${sourceDir}/build-release",
      "toolchainFile": "llvm-mingw.cmake",
      "cacheVariables": {
        "CMAKE_BUILD_TYPE": "Release",
        "CMAKE_CROSSCOMPILING_EMULATOR": "/opt/homebrew/bin/wine"
      },
      "vendor": {
        "qt.io/QtCreator/1.0": {
          "debugger": {
            "DisplayName": "LLDB 18.1.6 (CMake Preset)",
            "Abis": ["x86-darwin-generic-mach_o-64bit", "arm-darwin-generic-mach_o-64bit"],
            "Binary": "/Users/jdoe/llvm-mingw/bin/lldb",
            "EngineType": 256,
            "Version": "18.1.6"
          }
        }
      }
    }
  ]
}

조건 사용

다음 구성 프리셋은 condition 과 일치하는 경우 사용됩니다. 즉, hostSystemName 이 Linux 과 같으면 linux 프리셋이 사용되고 Windows 과 같으면 windows 프리셋이 사용됩니다.

{
  "version": 3,
  "configurePresets": [
    {
      "name": "linux",
      "displayName": "Linux GCC",
      "binaryDir": "${sourceDir}/build",
      "cacheVariables": {
        "CMAKE_PREFIX_PATH": "$env{HOME}/Qt/6.4.0/gcc_64"
      },
      "condition": {
        "type": "equals",
        "lhs": "${hostSystemName}",
        "rhs": "Linux"
      }
    },
    {
      "name": "windows",
      "displayName": "Windows MSVC",
      "binaryDir": "${sourceDir}/build",
      "cacheVariables": {
        "CMAKE_PREFIX_PATH": "$env{SYSTEMDRIVE}/Qt/6.4.0/msvc2019_64"
      },
      "condition": {
        "type": "equals",
        "lhs": "${hostSystemName}",
        "rhs": "Windows"
      }
    }
  ]
}

테스트 프리셋

다음 테스트 프리셋은 실패 시 테스트 실행을 중지하고 테스트 프로그램의 출력을 인쇄하고 테스트를 찾을 수 없는 경우 오류를 표시하도록 CMake에 지시합니다.

{
  "version": 3,
  "testPresets": [
  {
    "name": "default",
    "configurePreset": "default",
    "output": {"outputOnFailure": true},
    "execution": {"noTestsAction": "error", "stopOnFailure": true}
    }
  ],
}

CMake 빌드 구성, CMake, CMake Qt 공급업체 프리셋 및 SDK 도구도참조하십시오 .

CMake 빌드 구성 CMake Qt 벤더 프리셋

Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.