CMake 프로젝트에서 Qt 사용 가능하게 하기
현재 사용자 프로젝트에서 Qt를 사용할 수 있도록 하는 유일한 지원 방법은 시스템에 Qt를 미리 설치해 두거나, Qt를 미리 빌드하여 find_packagevcpkg 과 같은 방식입니다.
xml-ph-0000@deepl.internal Qt Creatorqt-cmake (Windows에서는qt-cmake.bat )을 사용할 때, Qt 설치 위치는 기본 CMake 호출로 자동으로 전달됩니다.
cmake 을 직접 사용할 경우, CMake가 사용하는 일반적인 검색 경로는 사용자 설치가 아닌 대부분의 Qt 설치를 포함합니다. 사용할 Qt 패키지를 더 세밀하게 제어하려면, Qt 설치 경로를 가리키는 환경 변수 또는 캐시 변수로 https://cmake.org/cmake/help/latest/variable/PackageName_ROOT.html Qt6_ROOT 을 전달하거나, 유사한 방식으로 CMAKE_PREFIX_PATH 에 추가하거나 뒤에 붙일 수 있습니다. 예를 들어, 설치 경로가 "~/Qt/6.12.0/gcc_64" 인 경우, 명령줄에서 -DQt6_ROOT=$HOME/Qt/6.12.0/gcc_64 로 전달하면 됩니다.
참고: 크로스 컴파일(WebAssembly나 Android 등 현재 사용 중인 플랫폼이 아닌 다른 플랫폼을 위한 컴파일)시나 기본 cmake 을 사용할 때는 Qt6_ROOT 이나 CMAKE_PREFIX_PATH 과 같은 검색 경로 대신 CMAKE_TOOLCHAIN_FILE 을 설정해야 합니다. Linux에서 툴체인 파일(특정 대상 플랫폼에 해당)은 일반적으로 "~/Qt/6.12.0/wasm_singlethread/lib/cmake/Qt6/qt.toolchain.cmake" 와 유사한 경로에 위치합니다. 이 파일은 CMAKE_PREFIX_PATH, CMAKE_FIND_ROOT_PATH, QT_HOST_PATH 와 같은 필수 변수를 설정합니다.
cmake_minimum_required(VERSION 3.16)
project(helloworld)
find_package(Qt6 REQUIRED)Qt 패키지는 프로젝트의 범위에 따라 포함해야 하는 다양한 모듈로 나뉘어 있으며, 그중 가장 기본적인 모듈은
find_package(Qt6 REQUIRED COMPONENTS Core)최신 CMake는 FetchContent 와 같은 다른 종속성 제공자를 지원하지만, CMake 자체 내에서 Qt 기능이 긴밀하게 통합되어 있기 때문에 FetchContent 를 사용하여 Qt를 사용하는 것은 지원되지 않습니다. add_subdirectory 및 Git 서브모듈을 통해 Qt 소스 코드를 추가하는 것도 지원되지 않습니다.
참고: find_package(Qt6) 를 해당 함수가 사용되는 디렉터리가 아닌 다른 하위 디렉터리에서호출하거나 , function 내부에서호출하는 것은 지원되지 않습니다. 이렇게 할 경우 예측할 수 없는 위치에서 다양한 오류가 발생할 수 있습니다.
대신, Qt 함수를 사용하는 모든 하위 디렉터리 범위에서 find_package(Qt6) 를 반복적으로 호출하거나, find_package(Qt6) 호출을 루트 CMakeLists.txt 로 이동하십시오.
© 2026 The Qt Company Ltd. 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.