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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
|
// Copyright (C) 2021 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/* NOTE: The variables documented here are available when running a deploy
** script, they are not available at configure time (i.e. when running
** CMake). Both these and the set of configure-time variables are all
** members of the cmake-variables-qtcore group.
**/
/*!
\page cmake-variable-qt-deploy-prefix.html
\ingroup cmake-variables-qtcore
\title QT_DEPLOY_PREFIX
\target cmake-variable-QT_DEPLOY_PREFIX
\summary {Base location for a deployment.}
\include cmake-deploy-var-usage.qdocinc
\cmakevariablesince 6.3
\preliminarycmakevariable
\c{QT_DEPLOY_PREFIX} provides the base deployment directory. The other
\c{QT_DEPLOY_..._DIR} variables should be treated as relative to this location.
The value of \c{QT_DEPLOY_PREFIX} may be relative or absolute, so projects
should not assume one or the other in any given situation. A relative path is
expected to be treated as relative to the current working directory, as seen
by the build tool (ninja, make, and so on) at install time.
The default value is \c{$ENV{DESTDIR}${CMAKE_INSTALL_PREFIX}}, which is the
base location CMake uses during installation. If that evaluates to an empty
string, the default value will be a dot (.) instead, which is generally the
appropriate value when deploying as part of a post-build rule. This two-step
fallback logic ensures that projects can assume \c{QT_DEPLOY_PREFIX} will not
be an empty string, so it can safely be used as part of a path like
\c{${QT_DEPLOY_PREFIX}/${QT_DEPLOY_BIN_DIR}}.
To change the value of \c QT_DEPLOY_PREFIX, the project can be configured
with a custom \l CMAKE_INSTALL_PREFIX as described in
\l {Command Line cmake invocation}.
The \l DESTDIR environment variable can also be used to modify the final
installation, and thus deployment, location.
Projects should rarely need to use this variable. In typical scenarios, deploy
scripts should assume that the working directory is already set to the base
install location and just use the prefix-relative \c{QT_DEPLOY_..._DIR}
variables.
\sa QT_DEPLOY_SUPPORT, QT_DEPLOY_BIN_DIR, QT_DEPLOY_LIB_DIR,
QT_DEPLOY_PLUGINS_DIR, QT_DEPLOY_QML_DIR, QT_DEPLOY_TRANSLATIONS_DIR
*/
/*!
\page cmake-variable-qt-deploy-bin-dir.html
\ingroup cmake-variables-qtcore
\title QT_DEPLOY_BIN_DIR
\target cmake-variable-QT_DEPLOY_BIN_DIR
\summary {Prefix-relative subdirectory for deploying runtime binaries on some target platforms.}
\include cmake-deploy-var-usage.qdocinc
\cmakevariablesince 6.3
\preliminarycmakevariable
Projects should use \c QT_DEPLOY_BIN_DIR in their deploy scripts to avoid
hard-coding a particular directory in which to deploy the following types of
binaries:
\list
\li Executables on all platforms.
\li DLLs on Windows.
\endlist
\c QT_DEPLOY_BIN_DIR defaults to the value of \c${CMAKE_INSTALL_BINDIR}
(usually \c{bin}), which is provided by CMake's \l{GNUInstallDirs} module.
To change the value of \c QT_DEPLOY_BIN_DIR, ensure that the project sets
\c{CMAKE_INSTALL_BINDIR} before the \c Core package is found.
The \c QT_DEPLOY_BIN_DIR path is relative to \l{QT_DEPLOY_PREFIX}.
This variable is not meaningful when deploying into a macOS app bundle and
should not be used for that scenario.
\section1 Example
\include cmake-deploy-runtime-dependencies.qdocinc
\sa QT_DEPLOY_SUPPORT, QT_DEPLOY_PREFIX, QT_DEPLOY_LIB_DIR,
QT_DEPLOY_PLUGINS_DIR, QT_DEPLOY_QML_DIR, QT_DEPLOY_TRANSLATIONS_DIR
*/
/*!
\page cmake-variable-qt-deploy-lib-dir.html
\ingroup cmake-variables-qtcore
\title QT_DEPLOY_LIB_DIR
\target cmake-variable-QT_DEPLOY_LIB_DIR
\summary {Prefix-relative subdirectory for deploying libraries on some target platforms.}
\include cmake-deploy-var-usage.qdocinc
\cmakevariablesince 6.3
\preliminarycmakevariable
Projects should use \c QT_DEPLOY_LIB_DIR in their deploy scripts to avoid
hard-coding a particular directory in which to deploy the following types of
binaries:
\list
\li Shared libraries on platforms other than Windows.
\li Import libraries on Windows.
\endlist
\c QT_DEPLOY_LIB_DIR defaults to the value of \c${CMAKE_INSTALL_LIBDIR}
(usually \c{lib} or \c{lib64}), which is provided by
CMake's \l{GNUInstallDirs} module.
To change the value of \c QT_DEPLOY_LIB_DIR, ensure that the project sets
\c{CMAKE_INSTALL_LIBDIR} before the \c Core package is found.
The \c QT_DEPLOY_LIB_DIR path is relative to \l{QT_DEPLOY_PREFIX}.
This variable is not meaningful when deploying into a macOS app bundle and
should not be used for that scenario.
\section1 Example
\include cmake-deploy-modified-variable-values.qdocinc
\sa QT_DEPLOY_SUPPORT, QT_DEPLOY_PREFIX, QT_DEPLOY_BIN_DIR,
QT_DEPLOY_PLUGINS_DIR, QT_DEPLOY_QML_DIR, QT_DEPLOY_TRANSLATIONS_DIR
*/
/*!
\page cmake-variable-qt-deploy-plugins-dir.html
\ingroup cmake-variables-qtcore
\title QT_DEPLOY_PLUGINS_DIR
\target cmake-variable-QT_DEPLOY_PLUGINS_DIR
\summary {Prefix-relative subdirectory for deploying Qt plugins on some target platforms.}
\include cmake-deploy-var-usage.qdocinc
\cmakevariablesince 6.3
\preliminarycmakevariable
Projects should use \c QT_DEPLOY_PLUGINS_DIR in their deploy scripts to avoid
hard-coding a particular directory under which to deploy plugins.
\c QT_DEPLOY_PLUGINS_DIR defaults to the value \c{plugins}. To change the value
of \c QT_DEPLOY_PLUGINS_DIR, set it in the project deployment script
before \c QT_DEPLOY_SUPPORT is included.
The \c QT_DEPLOY_PLUGINS_DIR path is relative to \l{QT_DEPLOY_PREFIX}.
This variable is not meaningful when deploying into a macOS app bundle and
should not be used for that scenario. Apple's macOS app bundle guidelines
require all plugins to be deployed to the \c{PlugIns} subdirectory of the
bundle contents.
\section1 Example
\include cmake-deploy-modified-variable-values.qdocinc
\sa QT_DEPLOY_SUPPORT, QT_DEPLOY_PREFIX, QT_DEPLOY_BIN_DIR, QT_DEPLOY_LIB_DIR,
QT_DEPLOY_QML_DIR, QT_DEPLOY_TRANSLATIONS_DIR
*/
/*!
\page cmake-variable-qt-deploy-qml-dir.html
\ingroup cmake-variables-qtcore
\title QT_DEPLOY_QML_DIR
\target cmake-variable-QT_DEPLOY_QML_DIR
\summary {Prefix-relative subdirectory for deploying QML plugins on some target platforms.}
\include cmake-deploy-var-usage.qdocinc
\cmakevariablesince 6.3
\preliminarycmakevariable
Projects should use \c QT_DEPLOY_QML_DIR in their deploy scripts to avoid
hard-coding a particular directory under which to deploy QML modules.
\c QT_DEPLOY_QML_DIR defaults to the value \c{qml}. To change the value
of \c QT_DEPLOY_QML_DIR, set it in the project deployment script
before \c QT_DEPLOY_SUPPORT is included.
The \c QT_DEPLOY_QML_DIR path is relative to \l{QT_DEPLOY_PREFIX}.
This variable is not meaningful when deploying into a macOS app bundle and
should not be used for that scenario. Apple's macOS app bundle guidelines
require all plugins to be deployed to the \c{PlugIns} subdirectory of the
bundle contents, and all other non-binary files should generally be under the
\c{Resources} subdirectory. The different parts of a QML module therefore need
to be deployed to different locations within the app bundle.
\section1 Example
\include cmake-deploy-modified-variable-values.qdocinc
\sa QT_DEPLOY_SUPPORT, QT_DEPLOY_PREFIX, QT_DEPLOY_BIN_DIR, QT_DEPLOY_LIB_DIR,
QT_DEPLOY_PLUGINS_DIR, QT_DEPLOY_TRANSLATIONS_DIR
*/
/*!
\page cmake-variable-qt-deploy-translations-dir.html
\ingroup cmake-variables-qtcore
\title QT_DEPLOY_TRANSLATIONS_DIR
\target cmake-variable-QT_DEPLOY_TRANSLATIONS_DIR
\summary {Prefix-relative subdirectory for deploying Qt translations on some target platforms.}
\include cmake-deploy-var-usage.qdocinc
\cmakevariablesince 6.5
\preliminarycmakevariable
Projects should use \c QT_DEPLOY_TRANSLATIONS_DIR in their deploy scripts to
avoid hard-coding a particular directory under which to deploy translations.
\c QT_DEPLOY_TRANSLATIONS_DIR defaults to the value \c{translations}. To change
the value of \c QT_DEPLOY_TRANSLATIONS_DIR, set it in the project deployment
script before \c QT_DEPLOY_SUPPORT is included.
The \c QT_DEPLOY_TRANSLATIONS_DIR path is relative to \l{QT_DEPLOY_PREFIX}.
This variable is not meaningful when deploying on macOS or Windows.
\section1 Example
\include cmake-deploy-modified-variable-values.qdocinc
\sa QT_DEPLOY_SUPPORT, QT_DEPLOY_PREFIX, QT_DEPLOY_BIN_DIR, QT_DEPLOY_LIB_DIR,
QT_DEPLOY_PLUGINS_DIR, QT_DEPLOY_QML_DIR
*/
/*!
\page cmake-variable-qt-deploy-ignored-lib-dirs.html
\ingroup cmake-variables-qtcore
\title QT_DEPLOY_IGNORED_LIB_DIRS
\target cmake-variable-QT_DEPLOY_IGNORED_LIB_DIRS
\summary {Directories that are excluded from runtime dependencies search}
\include cmake-deploy-var-usage.qdocinc
\cmakevariablesince 6.5
\preliminarycmakevariable
This variable contains a list of directories that are not taken into account
when searching for runtime dependencies with \l{qt_deploy_runtime_dependencies}.
Projects may alter this variable before calling
\l{qt_deploy_runtime_dependencies} to control from which directory runtime
dependencies are deployed.
This variable is ignored if the \c{POST_EXCLUDE_REGEXES} option is specified in
the \l{qt_deploy_runtime_dependencies} call.
This variable is not meaningful when deploying on macOS or Windows.
\sa qt_deploy_runtime_dependencies
*/
|
