QT_DEPLOY_QML_DIR
Subdirectorio relativo al prefijo para desplegar plugins QML en algunas plataformas de destino.
Esta variable es definida por el script nombrado por QT_DEPLOY_SUPPORT. Sólo debe usarse como parte del despliegue durante la instalación o como una regla post-construcción.
Nota: Esta es una variable API de despliegue de bajo nivel, y sólo debe utilizarse en casos de uso avanzado que no están cubiertos por los comandos API de alto nivel, como qt_generate_deploy_app_script.
Esta variable se introdujo en Qt 6.3.
Los proyectos deberían utilizar QT_DEPLOY_QML_DIR en sus scripts de despliegue para evitar codificar un directorio concreto en el que desplegar los módulos QML.
QT_DEPLOY_QML_DIR El valor predeterminado es qml. Para cambiar el valor de QT_DEPLOY_QML_DIR, ajústelo en el script de despliegue del proyecto antes de incluir QT_DEPLOY_SUPPORT.
La ruta QT_DEPLOY_QML_DIR es relativa a QT_DEPLOY_PREFIX.
Esta variable no tiene sentido cuando se despliega en un paquete de aplicaciones macOS y no debe utilizarse en ese caso. Las directrices del paquete de aplicaciones macOS de Apple exigen que todos los plugins se desplieguen en el subdirectorio PlugIns del contenido del paquete, y todos los demás archivos no binarios deben estar generalmente en el subdirectorio Resources. Por lo tanto, las diferentes partes de un módulo QML deben desplegarse en diferentes ubicaciones dentro del paquete de aplicaciones.
Ejemplo
cmake_minimum_required(VERSION 3.16...3.22)
project(MyThings)
find_package(Qt6 REQUIRED COMPONENTS Quick)
qt_standard_project_setup()
qt_add_executable(MyApp main.cpp)
qt_add_qml_module(MyApp
URI myapp
QML_FILES main.qml
)
set(deploy_script "${CMAKE_CURRENT_BINARY_DIR}/deploy_MyApp.cmake")
file(GENERATE OUTPUT ${deploy_script} CONTENT "
set(QT_DEPLOY_QML_DIR \"myqmldir\")
include(\"${QT_DEPLOY_SUPPORT}\")
qt_deploy_qml_imports(
TARGET MyApp
PLUGINS_FOUND plugins_found
)
qt_deploy_runtime_dependencies(
EXECUTABLE \"\${QT_DEPLOY_BIN_DIR}/$<TARGET_FILE_NAME:MyApp>\"
ADDITIONAL_MODULES \${plugins_found}
)")
install(SCRIPT ${deploy_script})Ver también QT_DEPLOY_SUPPORT, QT_DEPLOY_PREFIX, QT_DEPLOY_BIN_DIR, QT_DEPLOY_LIBEXEC_DIR, QT_DEPLOY_LIB_DIR, QT_DEPLOY_PLUGINS_DIR, y QT_DEPLOY_TRANSLATIONS_DIR.
© 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.