QML용 CMake 통합

Qt Qml 모듈 및 애플리케이션을 빌드하기 위한 광범위한 CMake 통합 기능을 제공합니다.

핵심 CMake 명령어

qt_add_qml_module

qt_add_qml_module 명령어는 CMake에서 QML 모듈을 생성하는 주요 기능입니다. 이 명령어는 QML 유형 등록, 리소스 임베딩, 플러그인 생성 및 Qt 빌드 시스템과의 통합을 처리하며, QML 모듈의 모든 측면을 선언적인 방식으로 정의할 수 있게 해줍니다.

qt_target_qml_sources

qt_target_qml_sources 명령어는 기존 QML 모듈 타깃에 QML 파일과 리소스를 추가합니다. 이 명령어는 대규모 모듈을 구성하거나 빌드 구성에 따라 QML 파일을 조건부로 포함할 때 유용합니다.

qt_add_qml_plugin

qt_add_qml_plugin 명령어는 QML 엔진에서 동적으로 로드할 수 있는 QML 플러그인 라이브러리를 생성합니다. 일반적으로 qt_add_qml_module 가 플러그인 생성을 자동으로 처리하지만, 이 함수는 필요할 때 저수준 제어를 제공합니다.

배포 명령어

qt_deploy_qml_imports

qt_deploy_qml_imports 명령어는 의존성을 포함하여 애플리케이션에서 사용하는 모든 QML 임포트를 식별하고 배포합니다. 이를 통해 필요한 모든 QML 모듈과 플러그인이 애플리케이션과 함께 패키징되도록 보장합니다.

qt_generate_deploy_qml_app_script

qt_generate_deploy_qml_app_script 명령어는 QML 모듈, 플러그인 및 기타 리소스를 애플리케이션 번들 또는 설치 디렉터리의 올바른 위치로 복사하는 작업을 처리하는 플랫폼별 배포 스크립트를 생성합니다.

qt_import_qml_plugins

qt_import_qml_plugins 명령어는 QML 플러그인이 정적 빌드된 애플리케이션에 올바르게 링크되도록 보장하며, QML 엔진에 플러그인을 등록하는 데 필요한 초기화 코드를 생성합니다.

고급 명령어

qt_generate_foreign_qml_types

qt_generate_foreign_Qml_types 명령어는 다른 라이브러리나 모듈에 정의된 C++ 타입에 대한 Qml 타입 등록을 생성합니다. 이를 통해 소스 코드를 수정하지 않고도 타사 또는 Qt 타입을 Qml에 노출할 수 있습니다.

qt_query_qml_module

qt_query_qml_module 명령어는 QML 모듈의 URI, 버전, 플러그인 대상, 유형 정보 파일 경로와 같은 정보를 가져옵니다. 이는 빌드 시스템 내부 분석 및 툴링 통합에 유용합니다.

qt_target_compile_qml_to_cpp

qt_target_compile_qml_to_cpp 명령어는 qmltc(QML 타입 컴파일러)를 사용하여 QML 파일을 C++로 컴파일할 수 있게 해줍니다. 이는 정적으로 알려진 QML 타입에 대해 향상된 성능을 제공하며, 컴포넌트 기반 인스턴스화의 대안을 제공합니다.

qt_add_qml_preview

qt_add_qml_preview 명령어는 하나 이상의 qt_add_qml_module 타깃에서 QML을 로드하지만, 그 자체로는 QML 모듈이 아닌 실행 파일 타깃에 대해 qmlpreview 라이브 리로드 지원을 설정합니다. 이 명령은 실행 파일의 QML 파일을 미리 보는 데 사용할 수 있는 추가적인 <target>_qmlpreview 빌드 타깃을 생성합니다.

CMake 변수 및 속성

Qt Qml QML 모듈의 동작을 구성하기 위해 다음과 같은 여러 CMake 변수와 속성을 제공합니다:

전역 변수

Qt6 Qml의 CMake 전역 변수는 프로젝트 내 모든 QML 모듈에 대한 기본 동작을 제어합니다. 여기에는 출력 디렉터리, 캐시 파일 생성 및 툴링 통합을 위한 변수가 포함되어 있어, 프로젝트 전체 수준에서 QML 컴파일 설정을 구성할 수 있습니다.

전역 속성

Qt6 Qml의 CMake 전역 속성은 빌드 시스템이 QML 모듈을 처리하는 방식에 영향을 미치며, 린터(linter) 타깃 구성이나 빌드 시 코드 생성 같은 측면을 사용자 정의하는 데 사용할 수 있습니다.

소스 파일 속성

Qt6 QML의 CMake 소스 파일 속성을 사용하면 모듈 내 개별 QML 파일을 세밀하게 제어할 수 있습니다. 이러한 속성을 사용하여 파일을 싱글톤으로 표시하거나, 컴파일 단계에서 제외하거나, 사용자 정의 유형 이름을 지정하거나, QML 유형 시스템에서 파일별 동작을 제어할 수 있습니다.

타깃 속성

Qt6 Qml의 CMake 타깃 속성을 사용하면 개별 타깃의 동작을 미세하게 조정할 수 있습니다. 예를 들어, 자동 qmlpreview 타깃 생성처럼 프로젝트 전체에서 기본적으로 활성화되는 동작에서 특정 타깃을 제외할 수 있습니다.

CMake 정책

Qt Qml 이 문서에서는 하위 호환성 및 동작을 제어하기 위한 여러 CMake 정책을 정의합니다.

QML용 CMake 정책

'QML용 CMake 정책' 페이지에서는 모든 QML 관련 CMake 정책과 이러한 정책이 모듈 동작에 미치는 영향에 대한 개요를 제공합니다. 정책을 통해 기존 프로젝트와의 호환성을 유지하면서 새로운 동작을 적용할 수 있습니다.