qt_generate_deploy_app_script
Generar un script de implementación para una aplicación.
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.3.
Nota: Actualmente,este comando solo es compatible con Windows, macOS y Linux.
Sinopsis
qt_generate_deploy_app_script(
TARGET target
OUTPUT_SCRIPT <var>
[NO_TRANSLATIONS]
[NO_COMPILER_RUNTIME]
[NO_UNSUPPORTED_PLATFORM_ERROR]
[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 ...]
[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 en su lugar « qt6_generate_deploy_app_script() ». Admite el mismo conjunto de argumentos que este comando.
Descripción
Al instalar un objetivo ejecutable con `install(TARGETS)`, solo se instala el ejecutable del objetivo (excepto en el caso de los paquetes de aplicaciones de macOS, en los que se copia el paquete completo). Deberás instalar tú mismo de forma explícita cualquier otra biblioteca o complemento del que dependa el ejecutable. ` qt_generate_deploy_app_script() ` es un comando de conveniencia destinado a simplificar ese proceso. Se espera que la aplicación siga con bastante fidelidad 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).
El comando 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_runtime_dependencies() con un conjunto de opciones adecuado para la estructura de instalación estándar. Actualmente, esto solo está implementado para
- paquetes de aplicaciones de macOS compilados en un host de macOS,
- ejecutables de Linux compilados en un host de Linux,
- y los ejecutables de Windows compilados en un host de Windows.
La compilación cruzada de un ejecutable de Windows en un host Linux, así como otros casos similares, no están admitidos actualmente. Llamar a ` qt_generate_deploy_app_script() ` en tal caso provocará un error fatal, a menos que se especifique la opción ` NO_UNSUPPORTED_PLATFORM_ERROR `.
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, puede 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 sin modificaciones a la herramienta de implementación 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 « qt_generate_deploy_app_script() » sin especificar versión reenvía sus argumentos a través de una función o una macro, dependiendo del valor de QTP0008. Con el comportamiento de « OLD », un valor que contenga una barra invertida o una referencia a « ${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_app_script() evita este problema.
Para implementar una aplicación QML, utiliza en su lugar qt_generate_deploy_qml_app_script().
Para generar un script de implementación personalizado, utiliza qt_generate_deploy_script().
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 el despliegue 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.
Se puede desactivar por completo la implementación de complementos con la opción NO_PLUGINS.
Ejemplo
El siguiente ejemplo muestra cómo implementar una aplicación con la opción ` MyApp`.
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_app_script(
TARGET MyApp
OUTPUT_SCRIPT deploy_script
NO_UNSUPPORTED_PLATFORM_ERROR
)
install(SCRIPT ${deploy_script})El siguiente ejemplo muestra cómo utilizar el parámetro ` DEPLOY_TOOL_OPTIONS ` para pasar diferentes opciones a `macdeployqt` y `windeployqt`.
# 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_app_script(
TARGET MyApp
OUTPUT_SCRIPT deploy_script
NO_UNSUPPORTED_PLATFORM_ERROR
DEPLOY_TOOL_OPTIONS ${deploy_tool_options_arg}
)
install(SCRIPT ${deploy_script})Véase también qt_standard_project_setup(), qt_generate_deploy_script(), qt_generate_deploy_qml_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.