qt_set_finalizer_mode
Permite personalizar aspectos de la finalización de un objetivo.
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.2.
Nota: Este comando se encuentra en fase de vista previa tecnológica y puede sufrir cambios en futuras versiones.
Sinopsis
qt_set_finalizer_mode(target
ENABLE | DISABLE
MODES modes...
)Si los comandos sin versión están desactivados, utiliza en su lugar qt6_set_finalizer_mode(). Admite el mismo conjunto de argumentos que este comando.
Descripción
Este comando se utiliza para personalizar algunos aspectos de la finalización de un « target » específico. Solo surte efecto si se invoca antes de que se finalice « target », lo cual ocurre en uno de los siguientes casos:
- El proyecto invoca explícitamente qt_finalize_target() para
target. Esto suele significar que se pasó la palabra claveMANUAL_FINALIZATIONa qt_add_executable() cuando se definiótarget. - Se está utilizando CMake 3.17 o una versión anterior; en ese caso, la finalización siempre se produce de forma inmediata como parte de la llamada a `qt_add_executable()`.
- Si se está utilizando CMake 3.18 o posterior, la palabra clave
MANUAL_FINALIZATIONno se pasó a qt_add_executable() al definir eltarget, y la finalización diferida se ha completado al final del ámbito del directorio deltarget.
qt_set_finalizer_mode() se utiliza para habilitar o deshabilitar una lista de modos, donde cada modo corresponde a un aspecto específico de la finalización. Los modos de finalización actualmente compatibles son:
| Modo | Por defecto | Comportamiento de finalización |
|---|---|---|
static_plugins | Habilitado | Cuando Qt se compila de forma estática, crea bibliotecas de objetos inicializadores para sus complementos estáticos. Si target es un ejecutable y este modo de finalización está activado, cualquier biblioteca de objetos inicializadores de complementos que necesite el target se vinculará directamente a él. Esto evita ciclos entre las bibliotecas estáticas proporcionadas por Qt y puede reducir el tiempo de enlace. Cuando este modo de finalización está desactivado, cada inicializador de complemento se propaga a través de los requisitos de uso de su biblioteca Qt asociada, lo que puede provocar ciclos. Si Qt no se compila de forma estática, este modo de finalización no es relevante y no se utiliza. |
Ejemplo
El siguiente ejemplo da por hecho que estás utilizando CMake 3.19 o posterior (requerido para la finalización diferida):
qt_add_executable(my_app main.cpp)
qt_set_finalizer_mode(my_app ENABLE MODES static_plugins)El mismo ejemplo utilizando la finalización manual podría tener este aspecto:
qt_add_executable(my_app MANUAL_FINALIZATION main.cpp)
qt_set_finalizer_mode(my_app ENABLE MODES static_plugins)
qt_finalize_target(my_app)Véase también qt_finalize_target().
© 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.