CMake 변수 참조

Qt 빌드 변수

Qt를 빌드할 때 CMake 변수를 사용하여 빌드 결과를 제어할 수 있습니다.

변수	설명
QT_HOST_PATH	일반 빌드나 크로스 컴파일 빌드 등 다른 Qt 빌드 과정에서 호스트 도구를 사용할 수 있도록 하는 호스트 Qt 설치 위치입니다.
`QT_FORCE_BUILD_TOOLS`	호스트 도구가 이미 발견된 경우에도 빌드 도구를 강제로 사용합니다. Qt를 크로스 컴파일할 때 SDK에 크로스 빌드된 도구가 있는지 확인하는 데 유용합니다.
`QT_FORCE_FIND_TOOLS`	크로스 컴파일을 수행하지 않을 경우, ` `QT_HOST_PATH` `에 있는 사전 빌드된 Qt의 도구를 사용합니다. 이 변수는 ` `QT_FORCE_BUILD_TOOLS` `가 ` `ON``로 설정된 경우에만 적용됩니다. 그렇지 않으면 ` `QT_FORCE_FIND_TOOLS` `는 기본 동작에 영향을 미치지 않습니다.

모듈 변수

find_package 로 로드된 Qt 모듈은 다양한 변수를 설정합니다.

참고: 이러한 변수에 직접 접근해야할 경우는 거의없습니다 . 모듈에 대한 링크와 같은 일반적인 작업은 각 모듈이 정의하는 라이브러리 타깃을 통해 수행해야 합니다.

예를 들어, ` find_package(Qt6 COMPONENTS Widgets)`이 성공하면 다음 변수들을 사용할 수 있게 됩니다:

변수	설명
`Qt6Widgets_COMPILE_DEFINITIONS`	라이브러리를 대상으로 빌드할 때 사용할 컴파일 정의 목록입니다.
`Qt6Widgets_DEFINITIONS`	라이브러리를 대상으로 빌드할 때 사용할 정의 목록입니다.
`Qt6Widgets_EXECUTABLE_COMPILE_FLAGS`	라이브러리를 사용하여 실행 파일을 빌드할 때 사용할 플래그 문자열입니다.
`Qt6Widgets_FOUND`	모듈을 성공적으로 찾았는지 여부를 나타내는 부울 값입니다.
`Qt6Widgets_INCLUDE_DIRS`	라이브러리를 대상으로 빌드할 때 사용할 포함 디렉터리 목록입니다.
`Qt6Widgets_LIBRARIES`	모듈에 대해 가져온 타깃의 이름: `Qt6::Widgets`
`Qt6Widgets_PRIVATE_INCLUDE_DIRS`	라이브러리를 대상으로 빌드하고 비공개 Qt API를 사용할 때 사용할 비공개 포함 디렉터리 목록.
`Qt6Widgets_VERSION`	모듈의 버전이 포함된 문자열입니다.

find_package 로 발견된 모든 패키지에 대해, 이러한 변수와 동등한 변수를 사용할 수 있으며, 대소문자를 구분합니다.

설치 변수

또한, 특정 패키지와는 관련이 없지만 Qt 설치 자체와 관련된 변수도 있습니다.

변수	설명
`QT_DEFAULT_MAJOR_VERSION`	Qt 5와 Qt 6 프로젝트가 혼합된 경우, `qt_` 명령이 전달할 Qt 버전을 제어하는 정수입니다. 해당 `find_package()` 호출 전에 `5` 또는 `6` 중 하나로 설정해야 합니다. `5` 로 설정된 경우, `qt_` 로 시작하는 명령은 `qt5_` 로 시작하는 해당 명령을 호출합니다. `6` 로 설정된 경우, `qt6_` 로 시작하는 해당 명령을 호출합니다. 설정되지 않은 경우, 첫 번째 `find_package` 호출이 기본 버전을 정의합니다.
`QT_LIBINFIX`	Qt가 `-libinfix` 로 구성되었을 때, 라이브러리 이름에 사용되는 접미사를 포함하는 문자열입니다.
`QT_NO_CREATE_VERSIONLESS_FUNCTIONS`	`qt_` 로 시작하는 명령을 숨기고, `qt6_` 로 시작하는 버전이 지정된 명령만 남깁니다.
`QT_NO_CREATE_VERSIONLESS_TARGETS`	`Qt::` 로 시작하는 임포트된 타깃을 숨깁니다. 대신 `Qt6::` 로 시작하는 타깃을 사용해야 합니다.
`QT_VISIBILITY_AVAILABLE`	Unix에서, Qt 라이브러리와 플러그인이 `-fvisibility=hidden` 로 컴파일되었는지 여부를 나타내는 부울 값입니다. 이는 선택된 심볼만 내보낸다는 것을 의미합니다.

프로젝트 변수

이러한 변수는 Qt에서 제공하는 CMake 명령에 영향을 미칠 수 있습니다. 이러한 변수는 프로젝트, 툴체인 파일 또는 기타 타사 패키지에 의해 설정될 수 있습니다.

`Qt6::Core`

ANDROID_NDK_HOST_SYSTEM_NAME	호스트 시스템의 Android 전용 아키텍처
ANDROID_SDK_ROOT	Android SDK의 위치
QT_ANDROID_ABIS	프로젝트 패키지가 빌드되는 ABI 목록
QT_ANDROID_APPLICATION_ARGUMENTS	Android 애플리케이션에 전달할 인자 목록
QT_ANDROID_BUILD_ALL_ABIS	자동 감지된 Qt for Android SDK 목록을 사용하여 다중 ABI 패키지를 빌드할 수 있도록 합니다
QT_ANDROID_CREATE_SYMLINKS_ONLY	Gradle 프로젝트 디렉터리 하위 경로의 종속성에 대해서만 심볼릭 링크 생성
QT_ANDROID_DEPLOYMENT_TYPE	빌드 유형에 관계없이 릴리스 패키지 서명을 강제 적용하거나 비활성화합니다
QT_ANDROID_GENERATE_JAVA_QTQUICKVIEW_CONTENTS	QtQuickViewContent 기반 클래스 생성을 활성화합니다
QT_ANDROID_GRADLE_MULTI_MODULE	다중 모듈 Gradle 프로젝트에서 Android 패키지를 빌드합니다
QT_ANDROID_MULTI_ABI_FORWARD_VARS	다중 ABI 빌드에서 CMake 변수를 공유할 수 있도록 합니다
QT_ANDROID_POST_BUILD_GRADLE_CLEANUP	Android 패키지 생성 후 Gradle 정리 작업을 수행합니다
QT_ANDROID_SIGN_AAB	지정된 키스토어, 별칭 및 저장소 비밀번호를 사용하여 .aab 패키지에 서명합니다
QT_ANDROID_SIGN_APK	지정된 키스토어, 별칭 및 저장소 비밀번호를 사용하여 패키지에 서명합니다
QT_DEPLOY_BIN_DIR	일부 대상 플랫폼에 런타임 바이너리를 배포하기 위한 접두사 상대 하위 디렉터리
QT_DEPLOY_IGNORED_LIB_DIRS	런타임 종속성 검색에서 제외되는 디렉터리
QT_DEPLOY_LIBEXEC_DIR	일부 대상 플랫폼에 프로그램 실행 파일을 배포하기 위한 접두사 상대 하위 디렉터리
QT_DEPLOY_LIB_DIR	일부 대상 플랫폼에서 라이브러리를 배포하기 위한 접두사 상대 하위 디렉터리
QT_DEPLOY_PLUGINS_DIR	일부 대상 플랫폼에서 Qt 플러그인을 배포하기 위한 접두사 상대 하위 디렉터리
QT_DEPLOY_PREFIX	배포를 위한 기본 위치
QT_DEPLOY_QML_DIR	일부 대상 플랫폼에서 QML 플러그인을 배포하기 위한 접두사 상대 하위 디렉터리
QT_DEPLOY_SUPPORT	배포 지원 설정을 위해 포함해야 할 파일의 이름
QT_DEPLOY_TRANSLATIONS_DIR	일부 대상 플랫폼에서 Qt 번역을 배포하기 위한 접두사 상대 하위 디렉터리
QT_ENABLE_VERBOSE_DEPLOYMENT	배포 도구의 상세 모드 활성화
QT_HOST_PATH	크로스 컴파일 시 호스트 Qt 설치 위치
QT_I18N_SOURCE_LANGUAGE	번역 가능한 문자열의 언어를 지정합니다
QT_I18N_TRANSLATED_LANGUAGES	프로젝트 국제화에 사용할 언어 목록
QT_IOS_LAUNCH_SCREEN	모든 대상에서 사용하는 iOS 시작 화면 스토리보드의 경로
QT_NO_COLLECT_BUILD_TREE_APK_DEPS	Android 배포 시 프로젝트에서 빌드된 공유 라이브러리 타깃의 수집을 방지합니다
QT_NO_COLLECT_IMPORTED_TARGET_APK_DEPS	Android 배포 시 임포트된 타깃의 수집 방지
QT_NO_SET_XCODE_BUNDLE_IDENTIFIER	iOS에서 타겟 최종 확정 시 대체 앱 번들 ID 제공을 비활성화합니다
QT_NO_SET_XCODE_DEVELOPMENT_TEAM_ID	iOS에서 타겟 최종화 시 대체 팀 ID 제공을 비활성화합니다
QT_NO_STANDARD_PROJECT_SETUP	이후 qt_standard_project_setup() 호출 시 변경 사항이 적용되지 않도록 방지합니다
QT_PATH_ANDROID_ABI_<ABI>	해당 ABI에 대한 Qt for Android 경로를 지정하는 변수 세트
QT_USE_TARGET_ANDROID_BUILD_DIR	타겟별 Android 빌드 디렉터리 사용을 활성화합니다

`Qt6::InterfaceFramework`

IFCODEGEN_VERBOSE	모든 ifcodegen 함수에 대해 상세 로깅을 활성화합니다
QT_IFCODEGEN_TEMPLATE_SEARCH_PATH	ifcodegen 템플릿에 대한 검색 경로

`Qt6::Multimedia`

QT_NO_FFMPEG_XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY

iOS에서 FFmpeg 코드 서명을 비활성화합니다

`Qt6::Qml`

QT_QMLLINT_CONTEXT_PROPERTY_DUMP	lint 타깃에서 컨텍스트 속성 덤프 기능을 활성화합니다
QT_QML_GENERATE_AOTSTATS	QML 컴파일러 통계 수집을 활성화할지 여부를 제어합니다
QT_QML_GENERATE_QMLLS_INI	다음에 대한 .qmlls.ini 파일 자동 생성을 활성화합니다. QML Language Server
QT_QML_GENERATE_QMLLS_INI_NO_CMAKE_CALLS	다음에 대한 .qmlls.ini 파일의 no-cmake-calls 값 사용자 정의 QML Language Server
QT_QML_NO_CACHEGEN	QML 파일을 바이트코드 또는 C++ 코드로 컴파일하는 기능을 비활성화합니다
QT_QML_NO_QML_PREVIEW (global property)	Qt6::Qml을 링크하는 실행 파일에 대해 qmlpreview 지원이 자동으로 설정되는지 여부를 제어합니다
QT_QML_OUTPUT_DIRECTORY	기본적으로 QML 모듈이 생성될 기본 출력 디렉터리

표준 CMake 변수

CMAKE_AUTOGEN_BETTER_GRAPH_MULTI_CONFIG

다중 구성 생성기의 종속성 그래프를 개선합니다

CMake 명령어 참조 CMake 속성 참조

© 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.