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
|
// Copyright (C) 2020 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\page qt_add_resources.html
\ingroup cmake-commands-qtcore
\title qt_add_resources
\target qt6_add_resources
\summary {Compiles binary resources into source code.}
\include cmake-find-package-core.qdocinc
\section1 Synopsis
\badcode
qt_add_resources(<VAR> file1.qrc [file2.qrc ...]
[OPTIONS ...])
\endcode
\versionlessCMakeCommandsNote qt6_add_resources()
Since 6.0:
\badcode
qt_add_resources(<TARGET> <RESOURCE_NAME>
[PREFIX <PATH>]
[LANG <LANGUAGE>]
[BASE <PATH>]
[OUTPUT_TARGETS <VARIABLE_NAME>]
[FILES ...] [OPTIONS ...])
\endcode
\versionlessCMakeCommandsNote qt6_add_resources()
\section1 Description
To add resources, you can pass either a variable name or a target as the first
argument of the command.
When passing a variable name as first argument, \c qt_add_resources creates
source code from Qt resource files using the \l{Resource Compiler (rcc)}. Paths
to the generated source files are added to \c{<VAR>}.
When passing a target as first argument, the function creates a resource with
the name \c{RESOURCE_NAME}, containing the specified \c{FILES}. The resource is
automatically linked into \c{TARGET}.
For embedding bigger resources, see \l qt_add_big_resources.
See \l{The Qt Resource System} for a general description of Qt resources.
\section1 Arguments of the target-based variant
\c PREFIX specifies a path prefix under which all files of this resource are
accessible from C++ code. This corresponds to the XML attribute \c prefix of the
\c .qrc file format. If \c PREFIX is not given, the target property
\l{cmake-target-property-QT_RESOURCE_PREFIX}{QT_RESOURCE_PREFIX} is used.
\c LANG specifies the locale of this resource. This corresponds to the XML
attribute \c lang of the \c .qrc file format.
\c BASE is a path prefix that denotes the root point of the file's alias. For
example, if \c BASE is \c{"assets"} and \c FILES is
\c{"assets/images/logo.png"}, then the alias of that file is
\c{"images/logo.png"}.
Alias settings for files need to be set via the \c QT_RESOURCE_ALIAS source file
property.
When using this command with static libraries, one or more special targets will
be generated. Should you wish to perform additional processing on these targets,
pass a variable name to the \c OUTPUT_TARGETS parameter. The \c qt_add_resources
function stores the names of the special targets in the specified variable.
\section1 Arguments of both variants
You can set additional \c{OPTIONS} that should be added to the \c{rcc} calls.
You can find possible options in the \l{rcc}{rcc documentation}.
\section1 Examples
Variable variant, using a .qrc file:
\snippet cmake-macros/examples.cmake qt_add_resources
Target variant, using immediate resources:
\snippet cmake-macros/examples.cmake qt_add_resources_target
\section1 Caveats
When adding multiple resources, \c{RESOURCE_NAME} must be unique across all
resources linked into the final target.
This especially affects static builds. There, the same resource name in
different static libraries conflict in the consuming target.
*/
|