qt_set_finalizer_mode

Passt Aspekte der Finalisierung eines Ziels an.

Der Befehl ist in der Komponente „ Core “ des Pakets „ Qt6 “ definiert, das wie folgt geladen werden kann:

find_package(Qt6 REQUIRED COMPONENTS Core)

Dieser Befehl wurde in Qt 6.2 eingeführt.

Übersicht

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

Wenn versionslose Befehle deaktiviert sind, verwenden Sie stattdessen „ qt6_set_finalizer_mode() “. Dieser Befehl unterstützt dieselben Argumente wie der vorliegende Befehl.

Beschreibung

Dieser Befehl dient dazu, bestimmte Aspekte der Finalisierung eines bestimmten „ target “ anzupassen. Er wirkt sich nur aus, wenn er aufgerufen wird, bevor „ target “ finalisiert wird, was in einem der folgenden Szenarien geschieht:

• Das Projekt ruft explizit `qt_finalize_target() ` für das ` target` auf. Dies bedeutet in der Regel, dass das Schlüsselwort ` MANUAL_FINALIZATION ` an `qt_add_executable() ` übergeben wurde, als das ` target ` definiert wurde.
• Es wird CMake 3.17 oder früher verwendet; in diesem Fall erfolgt die Finalisierung immer sofort als Teil des Aufrufs von ` qt_add_executable()`.
• Wird CMake 3.18 oder höher verwendet, wurde das Schlüsselwort „ MANUAL_FINALIZATION “ bei der Definition des „ target “ nicht an „qt_add_executable()“ übergeben, und die verzögerte Finalisierung wurde am Ende des Verzeichnisbereichs des „ target “ abgeschlossen.

qt_set_finalizer_mode() wird verwendet, um eine Liste von Modi zu aktivieren oder zu deaktivieren, wobei ein Modus einem bestimmten Aspekt der Finalisierung entspricht. Die derzeit unterstützten Finalisierungsmodi sind:

Beispiel

Das folgende Beispiel setzt voraus, dass Sie CMake 3.19 oder höher verwenden (erforderlich für die verzögerte Finalisierung):

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

Das gleiche Beispiel mit manueller Finalisierung könnte wie folgt aussehen:

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