qt_deploy_qml_imports
Implementa los componentes de tiempo de ejecución de los módulos QML que necesita un ejecutable.
El comando está definido en el componente « Qml » del paquete « Qt6 », que se puede cargar de la siguiente manera:
find_package(Qt6 REQUIRED COMPONENTS Qml)A diferencia de la mayoría de los demás comandos de CMake proporcionados por Qt, qt_deploy_qml_imports solo se puede invocar desde un script de implementación. No se puede invocar directamente desde el proyecto.
Advertencia: Si utilizas una versión de CMake anterior a la 3.19, asegúrate de pasar la opción MANUAL_FINALIZATION a qt_add_executable() y, a continuación, llama a qt_finalize_target() antes de llamar a esta función.
Sinopsis
qt_deploy_qml_imports(
TARGET target
[QML_DIR qml_dir]
[PLUGINS_FOUND var_name]
[NO_QT_IMPORTS]
)Descripción
Nota: Normalmente no es necesario llamar aeste comando directamente. Lo utilizan internamente otros comandos de nivel superior, pero puede resultar útil para proyectos que deseen implementar una lógica de implementación más personalizada.
Al instalar una aplicación que utiliza QML, puede resultar complicado determinar qué módulos QML y qué partes de dichos módulos también deben instalarse. Dado que los complementos QML no están vinculados directamente al ejecutable de una aplicación, qt_deploy_runtime_dependencies() no encontrará estos módulos QML. El comando qt_deploy_qml_imports() proporciona la lógica necesaria que complementa a qt_deploy_runtime_dependencies() e implementa las partes de tiempo de ejecución de todos los módulos QML importados por la aplicación.
La opción ` TARGET ` es obligatoria y debe especificar un ` target ` que sea un ejecutable (en macOS, debe ser un paquete de aplicación) y también un módulo QML. Se analizarán de forma recursiva todas las fuentes QML que se hayan añadido a ` target ` mediante `qt_add_qml_module() ` o `qt_target_qml_sources()` en busca de importaciones QML. No se debe haber especificado la opción « NO_IMPORT_SCAN » en qt_add_qml_module(). Se implementarán los archivos « qmldir » y los complementos de los módulos QML importados. Se puede especificar la opción « NO_QT_IMPORTS » para omitir la implementación de cualquier módulo QML proporcionado por Qt.
De forma predeterminada, las partes de tiempo de ejecución de los módulos QML importados se implementarán en el directorio Resources/qml para un destino de paquete de aplicación de macOS, y en el directorio qml dentro de la ubicación de instalación base para otras plataformas. En el caso de plataformas distintas de macOS, se puede utilizar la opción QML_DIR para anular esta elección predeterminada.
El comando almacenará una lista de todos los complementos QML que implemente en la variable especificada por la opción PLUGINS_FOUND, si se ha indicado. A menudo, esta se pasa como el argumento ADDITIONAL_MODULES en una llamada posterior a qt_deploy_runtime_dependencies().
Ejemplo
cmake_minimum_required(VERSION 3.16...3.22)
project(MyThings)
find_package(Qt6 6.3 REQUIRED COMPONENTS Core Qml)
qt_standard_project_setup()
qt_add_executable(MyApp main.cpp)
qt_add_qml_module(MyApp
URI Application
VERSION 1.0
QML_FILES main.qml MyThing.qml
)
# The following script must only be executed at install time
set(deploy_script "${CMAKE_CURRENT_BINARY_DIR}/deploy_MyApp.cmake")
file(GENERATE OUTPUT ${deploy_script} CONTENT "
include(\"${QT_DEPLOY_SUPPORT}\")
qt_deploy_qml_imports(
# Deploy QML modules used by MyApp
TARGET MyApp
# The found QML plugins are stored in the plugins_found variable
PLUGINS_FOUND plugins_found
# The QML modules will be deployed into a custom directory
QML_DIR \"myqmldir\"
# Qt QML modules will be skipped, only project-created QML modules will be deployed
NO_QT_IMPORTS
)
# Deploy application runtime dependencies and runtime dependencies
# of the found QML module plugins.
qt_deploy_runtime_dependencies(
EXECUTABLE $<TARGET_FILE:MyApp>
ADDITIONAL_MODULES \${plugins_found}
)
")
install(TARGETS MyApp)
install(SCRIPT ${deploy_script})Véase también qt_generate_deploy_qml_app_script(), qt_deploy_runtime_dependencies() y QT_DEPLOY_QML_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.