qt_add_executable
Crea y finaliza un objetivo de aplicación de un tipo específico de la plataforma.
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.0.
Sinopsis
qt_add_executable(target
[WIN32] [MACOSX_BUNDLE]
[MANUAL_FINALIZATION]
sources...)Si los comandos sin versión están desactivados, utiliza en su lugar qt6_add_executable(). Admite el mismo conjunto de argumentos que este comando.
Descripción
Este comando realiza las siguientes tareas:
- Crea un objetivo CMake del tipo adecuado para la plataforma de destino.
- Enlaza el objetivo con la biblioteca
Qt::Core. - Gestiona la finalización del objetivo de CMake.
Creación del objetivo
En todas las plataformas, excepto en Android, se creará un objetivo ejecutable. Todos los argumentos se pasarán al comando estándar de CMake « add_executable() », excepto « MANUAL_FINALIZATION » (si está presente). En Android, se creará una biblioteca « MODULE » y se ignorarán las opciones « WIN32 » o « MACOSX_BUNDLE ». También se establecerán algunas propiedades del objetivo para Android:
- La propiedad de destino «
SUFFIX» se configurará para que el nombre del archivo de la biblioteca incluya un sufijo específico de la arquitectura. - Se establecerán varias propiedades del objetivo «
<lang>_VISIBILITY_PRESET» en «default» para garantizar que la función «main()» sea visible en el binario resultante.
Enlazado de Qt Core
Dado que todas las aplicaciones Qt deben enlazarse con la biblioteca Qt::Core, esto se realiza automáticamente para mayor comodidad.
Finalización
Una vez creado un objetivo, suele ser necesario realizar pasos adicionales de procesamiento o finalización. Los pasos a seguir dependen de la plataforma y de diversas propiedades del objetivo.
El procesamiento de finalización se lleva a cabo mediante dos comandos: ` qt_finalize_target() ` y ` qt_finalize_project()`.
La finalización del objetivo puede tener lugar como parte de la llamada a ` qt_add_executable ` o aplazarse hasta un momento posterior a la ejecución de este comando (aunque debe seguir estando dentro del ámbito del mismo directorio).
Cuando se utiliza CMake 3.19 o posterior, la finalización del objetivo se aplaza automáticamente hasta el final del ámbito del directorio actual. Esto ofrece al autor de la llamada la oportunidad de modificar las propiedades del objetivo creado antes de que se finalice. Cuando se utilizan versiones de CMake anteriores a la 3.19, no se admite el aplazamiento automático. En ese caso, la finalización del objetivo se lleva a cabo inmediatamente antes de que este comando devuelva un resultado.
Independientemente de la versión de CMake, se puede especificar la palabra clave « MANUAL_FINALIZATION » para indicar que usted mismo llamará explícitamente a `qt_finalize_target() ` más adelante. En general, ` MANUAL_FINALIZATION ` no debería ser necesario a menos que el proyecto tenga que ser compatible con CMake 3.18 o versiones anteriores.
La finalización del proyecto se produce automáticamente cuando se utiliza CMake 3.19 o posterior. Si se utiliza una versión anterior de CMake, se debe llamar a `qt_finalize_project()` manualmente, al final del archivo ` CMakeLists.txt ` raíz. Esto es especialmente importante cuando se compila para Android, a fin de recopilar las dependencias entre los objetivos del proyecto con fines de implementación.
Ejemplos
En el siguiente caso sencillo, la finalización se gestiona automáticamente. Si se utiliza una versión de CMake anterior a la 3.19, la finalización se llevará a cabo inmediatamente como parte de la llamada. Cuando se utiliza CMake 3.19 o posterior, la finalización tendrá lugar al final del ámbito del directorio actual.
qt_add_executable(simpleapp main.cpp)El siguiente ejemplo muestra un caso en el que la finalización debe aplazarse. La propiedad del objetivo « OUTPUT_NAME » afecta a la configuración de implementación en Android, pero dicha configuración se escribe como parte de la finalización del objetivo. Para garantizar la compatibilidad con versiones de CMake anteriores a la 3.19, nos encargamos de finalizar el objetivo añadiendo la palabra clave « MANUAL_FINALIZATION ».
qt_add_executable(complexapp MANUAL_FINALIZATION complex.cpp)
set_target_properties(complexapp PROPERTIES OUTPUT_NAME Complexify)
qt_finalize_target(complexapp)Advertencia: Si tu proyecto de Android se compila con una versión de CMake inferior a la 3.19, asegúrate de llamar a qt_finalize_project() al final de un archivo CMakeLists.txt de nivel superior.
Véase también qt_finalize_target(), qt_set_finalizer_mode(), qt_add_library() y qt_finalize_project().
© 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.