QQmlEngineExtensionPlugin Class

상세 설명

QQmlEngineExtensionPlugin 는 QML 애플리케이션에 동적으로 로드될 수 있는 QML 확장 기능을 생성할 수 있게 해주는 플러그인 인터페이스입니다. 이러한 확장 기능을 통해 사용자 정의 QML 유형을 QML 엔진에서 사용할 수 있게 됩니다.

QML 확장 플러그인을 작성하려면:

1. QQmlEngineExtensionPlugin 을 상속하고, Q_PLUGIN_METADATA() 매크로를 사용하여 Qt 메타 객체 시스템에 플러그인을 등록합니다.
2. QML_ELEMENT 및 QML_NAMED_ELEMENT() 매크로를 사용하여 QML 타입을 선언합니다.
3. 빌드 파일을 구성하십시오.

   CMake:

   qt_add_qml_module(<target>
       URI <my.import.name>
       VERSION 1.0
       QML_FILES <app.qml>
       NO_RESOURCE_TARGET_PATH
   )

   qmake:

   CONFIG += qmltypes
   QML_IMPORT_NAME = <my.import.name>
   QML_IMPORT_MAJOR_VERSION = <version>

4. qmake를 사용하는 경우, 플러그인을 설명하는 qmldir 파일을 생성하십시오. CMake는 기본적으로 qmldir 파일을 자동으로 생성한다는 점에 유의하십시오.

QML 확장 플러그인은 애플리케이션 전용 플러그인이나 라이브러리형 플러그인 중 하나에 해당합니다. 라이브러리형 플러그인은 타입 등록에만 국한되어야 합니다. 엔진의 루트 컨텍스트를 임의로 조작할 경우, 라이브러리 사용자의 코드에서 충돌이나 기타 문제가 발생할 수 있기 때문입니다.

링크러가 최적화 과정에서 생성된 타입 등록 함수를 실수로 제거할 수 있습니다. 코드 내 어딘가에 해당 함수를 가리키는 합성(synthetic) 휘발성(volatile) 포인터를 선언하면 이를 방지할 수 있습니다. 이 함수는 qmltyperegistrar에 의해 생성되며, 이름은 qml_register_types_ 에 모듈 URI를 연결하고, 점(.)을 밑줄(_)로 대체한 형태입니다.

모듈 이름이 "my.module"인 경우, 전역 범위에서 다음과 같이 선선언을 추가해야 합니다.

void qml_register_types_my_module();

그런 다음, 등록 함수와 동일한 바이너리에 포함되는 함수의 구현부에 다음 코드 스니펫을 추가합니다:

volatile auto registration = &qml_register_types_my_module;
Q_UNUSED(registration);

'C++를 사용한 QML 확장 기능 작성' 튜토리얼에는 QML 플러그인 생성에 관한 장도 포함되어 있습니다.