qt_set_finalizer_mode

Stellt Aspekte der Finalisierung eines Targets ein.

Dieser Befehl wurde in Qt 6.2 eingeführt.

Synopse

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

Wenn versionslose Befehle deaktiviert sind, verwenden Sie stattdessen qt6_set_finalizer_mode(). Er unterstützt die gleichen Argumente wie dieser Befehl.

Beschreibung

Dieser Befehl wird verwendet, um einige Aspekte der Finalisierung eines bestimmten target anzupassen. Er hat nur dann eine Wirkung, wenn er vor der Finalisierung von target aufgerufen wird, was in einem der folgenden Szenarien der Fall ist:

• Das Projekt ruft explizit qt_finalize_target() für die target auf. Das bedeutet normalerweise, dass das MANUAL_FINALIZATION Schlüsselwort an qt_add_executable() übergeben wurde, als die 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().
• CMake 3.18 oder höher wird verwendet, das Schlüsselwort MANUAL_FINALIZATION wurde nicht an qt_add_executable() übergeben, als target definiert wurde, und die aufgeschobene Finalisierung wurde am Ende des Verzeichnisbereichs von 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 geht davon aus, dass Sie CMake 3.19 oder höher verwenden (erforderlich für die latente 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)