qt_set_finalizer_mode

ターゲットのファイナライズをカスタマイズします。

このコマンドは Qt 6.2 で導入されました。

概要

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

バージョンレスコマンドが無効になっている場合、代わりにqt6_set_finalizer_mode() を使用してください。このコマンドと同じ引数セットをサポートしています。

説明

このコマンドは、特定のtarget のファイナライゼーションのいくつかの側面をカスタマイズするために使用される。このコマンドはtarget がファイナライズされる前に呼び出された場合のみ効果があります：

• プロジェクトがtarget に対して明示的にqt_finalize_target() を呼び出している。 これは通常、target が定義されたときにqt_add_executable()にMANUAL_FINALIZATION キーワードが渡されたことを意味します。
• CMake3.17以前が使用されている場合、qt_add_executable()の呼び出しの一部として、最終化は常に即座に行われます。
• CMake 3.18 またはそれ以降が使用されている場合、target が定義されたときにMANUAL_FINALIZATION キーワードがqt_add_executable()に渡されず、target のディレクトリスコープの最後で遅延されたファイナライズが完了しました。

qt_set_finalizer_mode() モードは最終化の特定の側面に対応します。現在サポートされている最終化モードは以下のとおりである：

例

以下の例では、CMake 3.19 以降（遅延ファイナライズに必要）を使用していると仮定しています：

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

手動ファイナライズを使用した同じ例は次のようになります：

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