qt_set_finalizer_mode

ターゲットのファイナライゼーションに関する設定をカスタマイズします。

このコマンドは、Qt6 パッケージのCore コンポーネントで定義されており、次のように読み込むことができます:

find_package(Qt6 REQUIRED COMPONENTS Core)

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

概要

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

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

説明

このコマンドは、特定の `target` の最終処理の一部の側面をカスタマイズするために使用されます。このコマンドは、`target ` が最終処理される前に呼び出された場合にのみ効果があります。最終処理が行われるのは、以下のいずれかのシナリオです:

• プロジェクトがtarget に対して明示的にqt_finalize_target() を呼び出す場合。これは通常、target が定義された際に、MANUAL_FINALIZATION キーワードがqt_add_executable()に渡されたことを意味します。
• CMake 3.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)