En esta página

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 clave MANUAL_FINALIZATION a 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_FINALIZATION no se pasó a qt_add_executable() al definir el target, y la finalización diferida se ha completado al final del ámbito del directorio del target.

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:

ModoPor defectoComportamiento de finalización
static_pluginsHabilitadoCuando 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.