qt5base-lts/cmake/QtPublicFinalizerHelpers.cmake

# Helper to check if the finalizer mode should be used.
# If true or unset, use finalizer mode.
# If false, use regular mode (usage requirement propagation via associated Qt module)
function(__qt_internal_check_finalizer_mode target out_var finalizer)
    get_target_property(value ${target} _qt_${finalizer}_finalizer_mode)
    if("${value}" STREQUAL "value-NOTFOUND")
        __qt_internal_enable_finalizer_mode(${target} ${finalizer} "TRUE")
        set(value "TRUE")
    endif()
    set(${out_var} "${value}" PARENT_SCOPE)
endfunction()

function(__qt_internal_enable_finalizer_mode target finalizer enabled)
    if(enabled)
        set(enabled "TRUE")
    else()
        set(enabled "FALSE")
    endif()
    set_property(TARGET "${target}" PROPERTY _qt_${finalizer}_finalizer_mode "${enabled}")
endfunction()
Implement propagation of object files to the end-point executable This proposal collects all the resource objects to the qt-specific property of the static libraries. This is done to avoid littering of other static libraries and put resource object files to the source part of the linker line when linking the end-point executable. The way we link object resource libraries is changed back to the target_link_libraries approach as we may omit using finalizers with linkers other than ld. Users may enforce finalizers by calling the qt6_enable_resource_objects_finalizer_mode function if need. Refactor tests related to the static resources. Amends ddaa7150d85624ab545ccfe098fe8b2d18241940 Task-number: QTBUG-93002 Change-Id: I74135e291cd82fb54d1b284b4b4a1e002b1fef98 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io> 2021-05-19 17:46:24 +00:00			`# Helper to check if the finalizer mode should be used.`
			`# If true or unset, use finalizer mode.`
			`# If false, use regular mode (usage requirement propagation via associated Qt module)`
			`function(__qt_internal_check_finalizer_mode target out_var finalizer)`
			`get_target_property(value ${target} _qt_${finalizer}_finalizer_mode)`
			`if("${value}" STREQUAL "value-NOTFOUND")`
Check the impact of static link order for user projects For user projects we run the static link order check once 'find_package(Qt6 ...)' is called. If linker can resolve circular dependencies between static libraries and object files we set the _qt_link_order_matters property of the Qt::Platform target. This indicates the use of finalizers is not required and we may rely on CMake-base propagation of resource libraries and resource object files. If linker could not resolve circular dependencies depending on the _qt_resource_objects_finalizer_mode value: - Finalizer will be called and collected resource objects will be linked to the target directly. - Finalizer will be omitted and resource objects will be linked using the target_sources function implicitly. This only propagates resource one level up if consumer links the static library PUBLICly, but all symbols will be resolved correctly since object files are placed in the beginning of the linker line. In the CMake version 3.21 we expect that CMake will take care about the order of the resource object files in a linker line, it's expected that all object files are located at the beginning of the linker line. TODO: Need to confirm that the CMake 3.21 meets the expectations. Amends 4e901a2f99cbfda3b479253ea54b16f02e1c3aa5 Pick-to: 6.2 Task-number: QTBUG-93002 Task-number: QTBUG-94528 Change-Id: Ia68976df8182d3d3007b90c475c1e3928a305339 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io> 2021-06-10 17:01:35 +00:00			`__qt_internal_enable_finalizer_mode(${target} ${finalizer} "TRUE")`
			`set(value "TRUE")`
Implement propagation of object files to the end-point executable This proposal collects all the resource objects to the qt-specific property of the static libraries. This is done to avoid littering of other static libraries and put resource object files to the source part of the linker line when linking the end-point executable. The way we link object resource libraries is changed back to the target_link_libraries approach as we may omit using finalizers with linkers other than ld. Users may enforce finalizers by calling the qt6_enable_resource_objects_finalizer_mode function if need. Refactor tests related to the static resources. Amends ddaa7150d85624ab545ccfe098fe8b2d18241940 Task-number: QTBUG-93002 Change-Id: I74135e291cd82fb54d1b284b4b4a1e002b1fef98 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io> 2021-05-19 17:46:24 +00:00			`endif()`
			`set(${out_var} "${value}" PARENT_SCOPE)`
			`endfunction()`

			`function(__qt_internal_enable_finalizer_mode target finalizer enabled)`
			`if(enabled)`
			`set(enabled "TRUE")`
			`else()`
			`set(enabled "FALSE")`
			`endif()`
			`set_property(TARGET "${target}" PROPERTY _qt_${finalizer}_finalizer_mode "${enabled}")`
			`endfunction()`