QT_DEPLOY_QML_DIR
Subdirectorio relativo al prefijo para implementar complementos QML en algunas plataformas de destino.
Esta variable la define el script cuyo nombre viene determinado por QT_DEPLOY_SUPPORT. Solo debe utilizarse como parte del proceso de implementación durante la instalación o en una regla posterior a la compilación.
Nota: Se trata de una variable de la API de implementación de bajo nivel, y solo debe utilizarse en casos de uso avanzados que no estén cubiertos por los comandos de la API de nivel superior, como qt_generate_deploy_app_script.
Esta variable se introdujo en Qt 6.3.
Los proyectos deben utilizar ` QT_DEPLOY_QML_DIR ` en sus scripts de implementación para evitar codificar de forma fija un directorio concreto en el que implementar los módulos QML.
QT_DEPLOY_QML_DIR El valor por defecto es qml. Para cambiar el valor de QT_DEPLOY_QML_DIR, configúralo en el script de implementación 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 al realizar la implementación en un paquete de aplicación de macOS y no debe utilizarse en ese caso. Las directrices de Apple para los paquetes de aplicaciones de macOS exigen que todos los complementos se implementen en el subdirectorio PlugIns del contenido del paquete, y que el resto de archivos no binarios se encuentren, por regla general, en el subdirectorio Resources. Por lo tanto, las diferentes partes de un módulo QML deben implementarse en distintas ubicaciones dentro del paquete de la aplicación.
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})Véase 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.