Qt Qml

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

모듈 사용

QML API

모듈의 QML 유형은 QtQml 가져오기를 통해 사용할 수 있습니다. 이 유형을 사용하려면 .qml 파일에 다음 import 문을 추가합니다:

import QtQml

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

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

C++ API

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

C++ API에는 익숙해져야 할 몇 가지 중요한 클래스가 포함되어 있습니다. 또한 자바스크립트 값을 저장할 수 있는 타입도 제공합니다.

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)

자세한 내용은 qt6_generate_foreign_qml_types를 참조하세요.

qmake로 빌드하기

qmake로 빌드하도록 모듈을 구성하려면 프로젝트의 .pro 파일에 QT 변수의 값으로 모듈을 추가합니다:

QT += qml

QML 유형 및 QML 모듈 등록하기

QML에서 사용할 유형을 등록하려면 먼저 CMake에서 qt_add_qml_module을 사용하여 QML 모듈을 정의해야 합니다. 그런 다음 새 모듈에 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 약소 일반 공중 사용 허가서, 버전 3 또는 GNU 일반 공중 사용 허가서, 버전 2입니다. 자세한 내용은 Qt 라이선스를 참조하십시오.

또한 Qt 6.8.2의 Qt Qml 에는 다음과 같은 허용 라이선스에 따른 타사 모듈이 포함될 수 있습니다: