qt_set_finalizer_mode

Personaliza aspectos de la finalización de un objetivo.

El comando está definido en el componente Core del paquete Qt6, que puede cargarse de este modo:

find_package(Qt6 REQUIRED COMPONENTS Core)

Este comando se introdujo en Qt 6.2.

Sinopsis

qt_set_finalizer_mode(target
    ENABLE | DISABLE
    MODES modes...
)

Si los comandos versionless están deshabilitados, utilice qt6_set_finalizer_mode() en su lugar. 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. Sólo tiene efecto si se llama antes de finalizar target, lo que ocurre en uno de los siguientes escenarios:

• El proyecto llama explícitamente a qt_finalize_target() para target. Esto normalmente significa que la palabra clave MANUAL_FINALIZATION se pasó a qt_add_executable() cuando se definió target.
• Se está utilizando CMake 3.17 o anterior, en cuyo caso la finalización siempre se produce inmediatamente como parte de la llamada a qt_add_executable().
• Se está utilizando CMake 3.18 o posterior, la palabra clave MANUAL_FINALIZATION no se pasó a qt_add_executable() cuando se definió target, y la finalización diferida se ha completado al final del ámbito de directorio de target.

qt_set_finalizer_mode() se utiliza para activar o desactivar una lista de modos, donde un modo corresponde a un aspecto específico de la finalización. Los modos de finalización actualmente soportados son:

Ejemplo

El siguiente ejemplo asume que se está usando CMake 3.19 o posterior (necesario 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 usando finalización manual podría verse así:

qt_add_executable(my_app MANUAL_FINALIZATION main.cpp)
qt_set_finalizer_mode(my_app ENABLE MODES static_plugins)
qt_finalize_target(my_app)