Qt Qml

Qt Qml 모듈은 QML 언어를 사용하여 애플리케이션과 라이브러리를 개발하기 위한 프레임워크를 제공합니다. 이 모듈은 언어 및 엔진 인프라를 정의하고 구현하며, 애플리케이션 개발자가 사용자 정의 QML 유형과 모듈을 등록하고 QML 코드를 JavaScript 및 C++와 통합할 수 있도록 하는 API를 제공합니다. Qt Qml 모듈은 QML API 와 C++ API 를 모두 제공합니다.

모듈 사용 방법

QML API

이 모듈의 QML 타입은 ` QtQml ` 임포트를 통해 사용할 수 있습니다. 타입을 사용하려면 .qml 파일에 다음 임포트 문을 추가하십시오:

import QtQml

Qt Qml 모듈에는 QML 프레임워크와 애플리케이션에서 사용되는 중요한 QML 유형이 포함되어 있습니다. QML의 구문은 『QML 레퍼런스』에 설명되어 있습니다.

Qt Qml 모듈의 QML API 은 다양한 QML 객체 유형, QML 값 유형 및 네임스페이스를 제공합니다.

C++ API

Qt 모듈의 C++ API를 사용하려면 모듈 라이브러리를 직접 또는 다른 종속성을 통해 링크해야 합니다. CMake 및 qmake를 비롯한 여러 빌드 도구가 이를 위해 전용 지원을 제공합니다.

C++ API에는 숙지해야 할 몇 가지 중요한 클래스가 포함되어 있습니다. 또한 JavaScript 값을 저장하는 데 사용되는 유형도 제공합니다.

CMake를 사용한 빌드

find_package() 명령어를 사용하여 Qt6 패키지에서 필요한 모듈 구성 요소를 찾으십시오:

find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)

자세한 내용은 ‘CMake를 사용한 빌드’ 개요를 참조하십시오.

QML이 아닌 라이브러리에 외부 QML 유형 지원을 제공하려면 다음과 같이 QmlIntegration 모듈을 찾아야 합니다:

find_package(Qt6 REQUIRED COMPONENTS QmlIntegration)
target_link_libraries(mytarget PRIVATE Qt6::QmlIntegration)

자세한 내용은 qt_generate_foreign_qml_types() 를 참조하십시오.

qmake를 사용한 빌드

qmake를 사용하여 빌드하도록 모듈을 구성하려면, 프로젝트의 .pro 파일에서 QT 변수의 값으로 해당 모듈을 추가하십시오:

QT += qml

QML 타입 및 QML 모듈 등록

QML에서 사용할 타입을 등록하려면 먼저 QML 모듈을 정의해야 하며, 가급적 CMake의 qt_add_qml_module()을 사용하는 것이 좋습니다. 그런 다음 새 모듈에 C++ 헤더 파일을 추가하고, 그 안에서 QML에 노출할 타입을 정의할 수 있습니다.

엔진 조정

QML 엔진의 동작을 사용자 정의하기 위해 조정할 수 있는 여러 가지 설정 항목이 있습니다. JavaScript 엔진 구성 페이지에는 이를 위해 사용할 수 있는 환경 변수들이 나열되어 있습니다. QML 디스크 캐시에 대한 설명에서는 QML 컴포넌트의 컴파일 및 로딩 방식과 관련된 옵션들을 다룹니다.

문서 및 가이드

다음 문서에는 Qt Qml 에 대한 정보가 포함되어 있습니다.

• QML 참조
• Qt Qml 툴링
• QML 모듈 작성
• QML의 싱글톤

참조

• C++ Classes
• QML Types

라이선스 및 출처 표기

Qt Qml 은 The Qt Company의 상용 라이선스에 따라 제공됩니다. 또한, 자유 소프트웨어 라이선스 하에서도 제공됩니다. Qt 5.4부터 이러한 자유 소프트웨어 라이선스는 GNU Lesser General Public License 버전 3 또는 GNU General Public License 버전 2입니다. 자세한 내용은 Qt 라이선싱을 참조하십시오.

또한 Qt 6.12.0의 Qt Qml 에는 다음의 허용적 라이선스에 따라 제공되는 타사 모듈이 포함될 수 있습니다: