En esta página

qt_generate_deploy_script

Generar un script de implementación personalizado.

El comando está definido en el componente « Core » del paquete « Qt6 », que se puede cargar de la siguiente manera:

find_package(Qt6 REQUIRED COMPONENTS Core)

Este comando se introdujo en Qt 6.5.

Sinopsis

qt_generate_deploy_script(
    OUTPUT_SCRIPT <var>
    [TARGET target]
    [NAME script_name]
    [CONTENT content]
)

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

Descripción

El comando genera un script cuya ruta de archivo completa 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 comando se encarga de generar un archivo con un nombre adecuado para los generadores multiconfiguración. Se añaden las inclusiones necesarias para que se pueda acceder a las funciones y variables de implementación de CMake de Qt.

El argumento « TARGET » especifica el objetivo que será implementado por el script. Esto afecta al nombre del archivo del script generado, a menos que se especifique « NAME ».

El argumento « NAME » controla una parte identificable dentro del nombre generado automáticamente del script de implementación. El argumento « NAME » toma por defecto el valor « custom » si no se especifica ni « NAME » ni « TARGET ».

El argumento CONTENT especifica el código que se escribe en el script de implementación. El contenido puede contener expresiones generadoras.

Nota: Al utilizar el comando qt_generate_deploy_script sin versión, las secuencias de escape y las referencias a ${var} en el contenido solo llegan al script generado sin modificaciones si QTP0008 está configurado en NEW. Con el comportamiento « OLD », se evalúan en el punto de llamada mientras se reenvían los argumentos, por lo que una referencia « QT_DEPLOY_* », que debería expandirse cuando se ejecuta el script, se expande en su lugar en el momento de la configuración, lo que da lugar a un valor vacío. Llamar directamente a ` qt6_generate_deploy_script() ` evita este problema.

Este comando está pensado para generar scripts de implementación personalizados que llaman directamente a funciones de la API de implementación de Qt. Para fines de implementación menos complejos, resulta más conveniente utilizar qt_generate_deploy_app_script() o qt_generate_deploy_qml_app_script().

Ejemplo

cmake_minimum_required(VERSION 3.16...3.22)
project(MyThings)

find_package(Qt6 REQUIRED COMPONENTS Core)
qt_standard_project_setup()

qt_add_executable(MyApp main.cpp)

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

qt_generate_deploy_script(
    TARGET MyApp
    OUTPUT_SCRIPT deploy_script
    CONTENT "
qt_deploy_runtime_dependencies(
    EXECUTABLE $<TARGET_FILE:MyApp>
)
")
install(SCRIPT ${deploy_script})

Véase también qt_generate_deploy_app_script(), qt_generate_deploy_qml_app_script() 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.