1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
/****************************************************************************
**
** Copyright (C) 2021 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
** $QT_END_LICENSE$
**
****************************************************************************/
/*!
\page qt_set_finalizer_mode.html
\ingroup cmake-commands-qtcore
\title qt_set_finalizer_mode
\target qt6_set_finalizer_mode
\summary {Customizes aspects of a target's finalization.}
\cmakecommandsince 6.2
\preliminarycmakecommand
\section1 Synopsis
\badcode
qt_set_finalizer_mode(target
ENABLE | DISABLE
MODES modes...
)
\endcode
\versionlessCMakeCommandsNote qt6_set_finalizer_mode()
\section1 Description
This command is used to customize some aspects of the finalization of a
specific \c target. It only has an effect if called before \c target is
finalized, which occurs in one of the following scenarios:
\list
\li The project explicitly calls \l{qt6_finalize_target}{qt_finalize_target()}
for the \c target. This usually means the \c MANUAL_FINALIZATION keyword was
passed to \l{qt6_add_executable}{qt_add_executable()} when the \c target
was defined.
\li CMake 3.17 or earlier is being used, in which case finalization always
occurs immediately as part of the call to
\l{qt6_add_executable}{qt_add_executable()}.
\li CMake 3.18 or later is being used, the \c MANUAL_FINALIZATION keyword was
not passed to \l{qt6_add_executable}{qt_add_executable()} when the \c target
was defined, and deferred finalization has been completed at the end of the
\c target's directory scope.
\endlist
\c{qt_set_finalizer_mode()} is used to enable or disable a list of \e modes,
where a mode corresponds to a specific aspect of finalization. The currently
supported finalization modes are:
\table
\header
\li Mode
\li Default
\li Finalization behavior
\row
\li \c static_plugins
\li Enabled
\li When Qt is built statically, it creates initializer object libraries
for its static plugins. If \c target is an executable and this
finalization mode is enabled, any plugin initializer object libraries
needed by the \c target will be directly linked to it. This
prevents cycles between Qt-provided static libraries and may reduce
link time. When this finalizer mode is disabled, each plugin
initializer is instead propagated via usage requirements of its
associated Qt library, which may cause cycles. If Qt is not built
statically, this finalizer mode is not relevant and isn't used.
\endtable
\sa {qt6_finalize_target}{qt_finalize_target()}
\section1 Example
The following example assumes you are using CMake 3.19 or later (required for
deferred finalization):
\badcode
qt_add_executable(my_app main.cpp)
qt_set_finalizer_mode(my_app ENABLE MODES static_plugins)
\endcode
The same example using manual finalization might look like this:
\badcode
qt_add_executable(my_app MANUAL_FINALIZATION main.cpp)
qt_set_finalizer_mode(my_app ENABLE MODES static_plugins)
qt_finalize_target(my_app)
\endcode
*/
|
