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 명령은 URI, 버전, 플러그인 대상 및 유형 정보 파일 경로와 같은 QML 모듈에 대한 정보를 검색합니다. 이 명령은 빌드 시스템 인트로스펙션 및 툴링 통합에 유용합니다.

qt_target_compile_qml_to_cpp

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

CMake 변수 및 속성

Qt QML은 QML 모듈 동작을 구성하기 위한 여러 CMake 변수와 프로퍼티를 제공합니다:

전역 변수

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

글로벌 속성

Qt6 Qml의 CMake 글로벌 속성은 빌드 시스템이 QML 모듈을 처리하는 방식에 영향을 미치며, 린터 대상 구성 및 빌드 시간 코드 생성과 같은 측면을 사용자 지정하는 데 사용할 수 있습니다.

소스 파일 속성

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

CMake 정책

Qt Qml은 이전 버전과의 호환성 및 동작을 제어하기 위해 몇 가지 CMake 정책을 정의합니다.

QML용 CMake 정책

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