Implementación
Utiliza la API de implementación de CMake de Qt para implementar proyectos Qt en plataformas de escritorio. La API es compatible con diversas plataformas de destino, que puedes consultar en la documentación de qt_generate_deploy_app_script().
El proceso de implementación depende de si su proyecto es una aplicación « Qt Widgets » o una aplicación « Qt Quick ». Aunque tenga previsto implementar únicamente aplicaciones « Qt Quick », le recomendamos que lea primero la información sobre la implementación de aplicaciones « Qt Widgets » para comprender el proceso.
Implementación de una aplicación « Qt Widgets »
En esta sección se explica cómo implementar una aplicación Qt Widgets con un ejemplo de un proyecto sencillo de C++ con Qt.
cmake_minimum_required(VERSION 3.16)
project(MyApp VERSION 1.0.0 LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
find_package(Qt6 REQUIRED COMPONENTS Core)
qt_standard_project_setup()
qt_add_executable(MyApp main.cpp)
target_link_libraries(MyApp PRIVATE Qt6::Core)Debe indicar a CMake que instale el objetivo de la aplicación en la ubicación adecuada. En macOS, los paquetes se instalan directamente en ${CMAKE_INSTALL_PREFIX}; en otras plataformas, en el directorio "bin" que se encuentra debajo.
install(TARGETS MyApp
BUNDLE DESTINATION .
RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
)Ten en cuenta que qt_standard_project_setup() incorpora la variable GNUInstallDirs.cmake de CMake. Esto es lo que define la variable CMAKE_INSTALL_BINDIR.
También es necesario generar un script de implementación. Un script de implementación es código CMake que se ejecuta en el momento de la instalación. Este código se encarga de recopilar las dependencias de tiempo de ejecución y copiarlas en el directorio de instalación.
qt_generate_deploy_app_script(
TARGET MyApp
OUTPUT_SCRIPT deploy_script
NO_UNSUPPORTED_PLATFORM_ERROR
)
install(SCRIPT ${deploy_script})El comando qt_generate_deploy_app_script() genera el script de implementación en el directorio de compilación. El nombre del archivo del script generado se almacena en la variable deploy_script. La llamada a install(SCRIPT) indica a CMake que ejecute el script durante la instalación.
El proyecto se puede instalar con cmake --install . o ninja install como cualquier otro proyecto basado en CMake. Tras la instalación, el directorio de instalación contiene las bibliotecas compartidas y los recursos necesarios para ejecutar la aplicación. En otras palabras, la instalación genera un directorio autónomo, listo para ser empaquetado —por ejemplo, mediante cpack —.
Implementación de una aplicación « Qt Quick »
La implementación de un proyecto « Qt Quick » requiere un comando diferente para generar el script de implementación. El resto de los pasos son similares a los de la implementación de una aplicación « Qt Widgets ».
En primer lugar, se crea la aplicación Qt Quick.
cmake_minimum_required(VERSION 3.16)
project(MyApp VERSION 1.0.0 LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
find_package(Qt6 REQUIRED COMPONENTS Core)
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
)Se instala la aplicación como antes.
install(TARGETS MyApp
BUNDLE DESTINATION .
RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
)Para generar el script de implementación, se llama a qt_generate_deploy_qml_app_script() en lugar de a qt_generate_deploy_app_script().
qt_generate_deploy_qml_app_script(
TARGET MyApp
OUTPUT_SCRIPT deploy_script
)
install(SCRIPT ${deploy_script})Durante la instalación, se implementará el binario de la aplicación, incluidos los archivos QML y las bibliotecas compartidas y los recursos de Qt que utiliza el proyecto. Una vez más, el directorio resultante es autónomo y puede empaquetarse con herramientas como cpack.
© 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.