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 가 정의될 때 qt_add_executable() 에 MANUAL_FINALIZATION 키워드가 전달되었음을 의미합니다.
• CMake 3.17 이하 버전을 사용하는 경우이며, 이 경우 최종 처리는 항상 qt_add_executable() 호출의 일부로 즉시 수행됩니다.
• CMake 3.18 이상이 사용 중이고, target 가 정의될 때 qt_add_executable() 에 MANUAL_FINALIZATION 키워드가 전달되지 않았으며, 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)