QT_HARMONYOS_EXTRA_PLUGINS

HarmonyOS 타깃과 함께 배포할 추가 Qt 플러그인.

이 속성은 Qt 6.12에서 도입되었습니다.

참고: 이 속성은 기술 미리보기 단계에 있으며 향후 릴리스에서 변경될 수 있습니다.

참고: 이 속성은 HarmonyOS 플랫폼을 대상으로 하는 경우에만 사용됩니다.

HAP에 패키징할 추가 Qt 플러그인 목록입니다. 이는 런타임 시에만 로드되는 플러그인 등 자동으로 감지할 수 없는 플러그인을 위한 것입니다.

각 목록 항목은 CMake 플러그인 타깃의 이름(플러그인의 라이브러리 파일로 해석됨)이거나 플러그인 라이브러리의 절대 경로입니다. HAP 내 플러그인의 카테고리는 플러그인 라이브러리의 상위 디렉터리 이름에서 파생되며, 예를 들어 imageformats 와 같습니다.

set_target_properties(myapp PROPERTIES
    QT_HARMONYOS_EXTRA_PLUGINS
        "${CMAKE_CURRENT_BINARY_DIR}/imageformats/libqcustomimg.so"
)

이 속성은 Qt 플러그인을 위한 것으로, 해당 플러그인은 해당 카테고리 디렉터리에 배치되어 Qt의 플러그인 시스템에 의해 로드됩니다. HAP의 라이브러리 디렉터리에 배치되어 동적 링커에 의해 해결되는 일반 공유 라이브러리를 배포하려면 대신 QT_HARMONYOS_EXTRA_LIBS를 사용하십시오.

프로젝트의 일부로 빌드되는 플러그인을 추가할 때는, 타깃이 배포되기 전에 플러그인을 사용할 수 있도록 빌드 종속성도 함께 추가해야 합니다:

add_dependencies(myapp qcustomimg)

QT_HARMONYOS_EXTRA_LIBS항목도 참조하십시오 .

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.