En esta página

qt_generate_deploy_qml_app_script

Genera un script de implementación para una aplicación QML.

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)

Este comando se introdujo en Qt 6.3.

Advertencia: Si utilizas una versión de CMake inferior 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_generate_deploy_qml_app_script(
    TARGET <target>
    OUTPUT_SCRIPT <var>
    [NO_UNSUPPORTED_PLATFORM_ERROR]
    [NO_TRANSLATIONS]
    [NO_COMPILER_RUNTIME]
    [NO_PLUGINS]                                  # since Qt 6.10
    [EXCLUDE_PLUGIN_TYPES type_or_target...]      # since Qt 6.10
    [INCLUDE_PLUGIN_TYPES type_or_target...]      # since Qt 6.10
    [EXCLUDE_PLUGINS name...]                     # since Qt 6.10
    [INCLUDE_PLUGINS name...]                     # since Qt 6.10
    [DEPLOY_TOOL_OPTIONS ...]
    [DEPLOY_USER_QML_MODULES_ON_UNSUPPORTED_PLATFORM]
    [PRE_INCLUDE_REGEXES regexes...]
    [PRE_EXCLUDE_REGEXES regexes...]
    [POST_INCLUDE_REGEXES regexes...]
    [POST_EXCLUDE_REGEXES regexes...]
    [POST_INCLUDE_FILES files...]
    [POST_EXCLUDE_FILES files...]
)

Si los comandos sin versión están desactivados, utiliza qt6_generate_deploy_qml_app_script() en su lugar. Admite el mismo conjunto de argumentos que este comando.

Descripción

La instalación de un objetivo ejecutable que también es un módulo QML requiere la implementación de varios elementos además del propio objetivo. Es posible que también sea necesario instalar las bibliotecas de Qt y otras bibliotecas del proyecto, los complementos de Qt y las partes de tiempo de ejecución de todos los módulos QML que utilice la aplicación. La estructura de instalación también será diferente para los paquetes de aplicaciones de macOS en comparación con otras plataformas. El comando ` qt_generate_deploy_qml_app_script() ` es un comando de conveniencia destinado a simplificar ese proceso, de forma similar a lo que hace `qt_generate_deploy_app_script()` para aplicaciones que no son QML.

El comando espera que la aplicación siga con bastante exactitud la estructura de directorios de instalación recomendada por Qt. Dicha estructura se basa en la disposición de instalación predeterminada de CMake, tal y como la determina GNUInstallDirs (excepto en el caso de los paquetes de aplicaciones de macOS, que siguen los requisitos de Apple). Los módulos QML se instalan en la ubicación adecuada para la plataforma. En el caso de los paquetes de macOS, el archivo ` qmldir ` de cada módulo QML se instala en el subdirectorio correspondiente dentro de ` Resources/qml `, y el complemento del módulo (si lo hay) se instala en ` PlugIns`. Se da por hecho que el paquete de la aplicación se instala directamente en la ubicación de instalación base (véase el ejemplo más adelante). Para el resto de plataformas, tanto el archivo ` qmldir ` como el complemento del módulo se instalan en el subdirectorio correspondiente de ` qml`, que a su vez es relativo a la ubicación de instalación base.

qt_generate_deploy_qml_app_script() genera un script cuyo nombre se almacenará en la variable especificada por la opción OUTPUT_SCRIPT. Dicho script solo se escribe en el momento de la generación de CMake. Está pensado para utilizarse con el comando install(SCRIPT), que debe ejecutarse después de que el objetivo de la aplicación se haya instalado mediante install(TARGETS).

El script de implementación llamará a ` qt_deploy_qml_imports() ` con un conjunto adecuado de opciones para la estructura de instalación estándar. En el caso de los paquetes de aplicaciones de macOS y los objetivos de Windows, también llamará a `qt_deploy_runtime_dependencies()`, de nuevo con las opciones adecuadas para la estructura de instalación estándar.

Llamar a ` qt_generate_deploy_qml_app_script() ` para una plataforma no compatible con qt_deploy_runtime_dependencies provocará un error fatal, a menos que se especifique la opción ` NO_UNSUPPORTED_PLATFORM_ERROR `. Cuando se especifica esta opción y el proyecto se compila para una plataforma no compatible, no se instalarán ni los módulos QML ni las dependencias de tiempo de ejecución habituales. Para garantizar que los módulos QML se instalen de todos modos, especifica ambas opciones: ` NO_UNSUPPORTED_PLATFORM_ERROR ` y ` DEPLOY_USER_QML_MODULES_ON_UNSUPPORTED_PLATFORM `. Esta última opción garantizará que los módulos QML compilados como parte del proyecto se instalen igualmente.

En plataformas distintas de macOS, las traducciones de Qt se implementan automáticamente. Para desactivar este comportamiento, especifica NO_TRANSLATIONS. Utiliza qt_deploy_translations() para implementar las traducciones de forma personalizada.

En el caso de las aplicaciones de escritorio para Windows, los archivos de tiempo de ejecución necesarios para el compilador también se instalan de forma predeterminada. Para evitarlo, especifica NO_COMPILER_RUNTIME.

Desde Qt 6.7, puedes utilizar ` DEPLOY_TOOL_OPTIONS ` para pasar opciones adicionales a la herramienta de implementación subyacente. Esto solo surte efecto si la herramienta de implementación subyacente es `macdeployqt` o `windeployqt`.

Nota: Un valor que contenga espacios en blanco, como una identidad de firma de código, solo llega a la herramienta de implementación sin modificaciones si QTP0007 se establece en NEW. Con el comportamiento OLD, dicho valor se escribe en el script generado sin comillas y se divide por los espacios en blanco, lo que los proyectos solían solucionar añadiendo otro nivel de comillas. Elimina esas comillas adicionales al configurar la política en « NEW ».

Nota: La opción sin versión « qt_generate_deploy_qml_app_script() » reenvía sus argumentos a través de una función o una macro, dependiendo del valor de QTP0008. Con el comportamiento « OLD », un valor que contenga una barra invertida o una referencia « ${var} » se evalúa en el momento de la expansión de la macro, por lo que una expresión regular como « foo\\.dylib » pierde un nivel de escape. Esto afecta a « DEPLOY_TOOL_OPTIONS » y a los argumentos de expresiones regulares y listas de archivos. Llamar directamente a qt6_generate_deploy_qml_app_script() evita este problema.

Se pueden especificar las opciones PRE_INCLUDE_REGEXES, PRE_EXCLUDE_REGEXES, POST_INCLUDE_REGEXES, POST_EXCLUDE_REGEXES, POST_INCLUDE_FILES y POST_EXCLUDE_FILES para controlar la implementación de las dependencias de tiempo de ejecución. Estas opciones no se aplican a todas las plataformas y se reenvían sin modificar a qt_deploy_runtime_dependencies().

Las opciones EXCLUDE_PLUGINS, EXCLUDE_PLUGIN_TYPES, INCLUDE_PLUGINS y INCLUDE_PLUGIN_TYPES se utilizan para seleccionar complementos de Qt. Consulte qt_deploy_runtime_dependencies() para ver su documentación.

Puede desactivar por completo la implementación de complementos con la opción NO_PLUGINS.

Para implementar una aplicación que no sea QML, utilice en su lugar qt_generate_deploy_app_script(). Se produce un error si se llaman tanto a qt_generate_deploy_qml_app_script() como a qt_generate_deploy_app_script() para el mismo objetivo.

Ejemplo

El siguiente ejemplo muestra cómo implementar una aplicación Qt Quick.

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
)

install(TARGETS MyApp
    BUNDLE  DESTINATION .
    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
)

qt_generate_deploy_qml_app_script(
    TARGET MyApp
    OUTPUT_SCRIPT deploy_script
    NO_UNSUPPORTED_PLATFORM_ERROR
    DEPLOY_USER_QML_MODULES_ON_UNSUPPORTED_PLATFORM
)
install(SCRIPT ${deploy_script})

El siguiente ejemplo muestra cómo pasar opciones adicionales a la herramienta de implementación subyacente.

# Pass the values on to the deploy tool unchanged, see \l {QTP0007}.
qt_policy(SET QTP0007 NEW)

set(deploy_tool_options_arg "")
if(APPLE)
    set(deploy_tool_options_arg
        --hardened-runtime
        "-codesign=Developer ID Application: Joe Developer (1234567890)"
    )
elseif(WIN32)
    set(deploy_tool_options_arg --no-compiler-runtime)
endif()

qt_generate_deploy_qml_app_script(
    ...
    DEPLOY_TOOL_OPTIONS ${deploy_tool_options_arg}
)
install(SCRIPT ${deploy_script})

Véase también qt_standard_project_setup(), qt_generate_deploy_app_script(), QTP0007 y QTP0008.

© 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.