将二进制资源编译进源代码。
命令的定义在
核心
组件对于
Qt6
包,可以像这样加载:
find_package(Qt6 REQUIRED COMPONENTS Core)
qt_add_resources(<VAR> file1.qrc [file2.qrc ...] [OPTIONS ...])
若
无版本命令
被禁用,使用
qt6_add_resources()
代替。它支持如此命令的一组相同自变量。
Since 6.0:
qt_add_resources(<TARGET> <RESOURCE_NAME> [PREFIX <PATH>] [LANG <LANGUAGE>] [BASE <PATH>] [BIG_RESOURCES] [OUTPUT_TARGETS <VARIABLE_NAME>] [FILES ...] [OPTIONS ...])
若
无版本命令
被禁用,使用
qt6_add_resources()
代替。它支持如此命令的一组相同自变量。
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,
qt_add_resources
creates source code from Qt resource files using the
RCC (资源编译器)
。将生成源文件的路径添加到
<VAR>
.
When passing a target as first argument, the function creates a resource with the name
RESOURCE_NAME
, containing the specified
FILES
. The resource is automatically linked into
TARGET
.
见 Qt 资源系统 for a general description of Qt resources.
PREFIX
specifies a path prefix under which all files of this resource are accessible from C++ code. This corresponds to the XML attribute
prefix
的
.qrc
file format. If
PREFIX
is not given, the target property
QT_RESOURCE_PREFIX
is used. Since 6.5,
PREFIX
is optional. If it is omitted and not specified by
QT_RESOURCE_PREFIX
,
"/"
will be used as the default path prefix.
LANG
specifies the locale of this resource. This corresponds to the XML attribute
lang
的
.qrc
file format.
BASE
is a path prefix that denotes the root point of the file's alias. For example, if
BASE
is
"assets"
and
FILES
is
"assets/images/logo.png"
, then the alias of that file is
"images/logo.png"
.
Alias settings for files need to be set via the
QT_RESOURCE_ALIAS
source file property.
BIG_RESOURCES
can be specified to enable support for big resources. This directly generates object files (
.o
,
.obj
) instead of C++ source code. This allows embedding bigger resources, without having to compile generated C++ sources, which can be too time consuming and memory intensive.
注意,
BIG_RESOURCES
is not compatible with iOS due to restrictions of CMake's Xcode project generator. See
QTBUG-103497
for details. Also,
BIG_RESOURCES
only works reliably from CMake 3.17 onwards.
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
OUTPUT_TARGETS
parameter. The
qt_add_resources
function stores the names of the special targets in the specified variable.
可以设置额外
选项
应该被添加到
rcc
调用。可以查找可能的选项在
RCC (资源编译器) 文档编制
.
Variable variant, using a .qrc file:
set(SOURCES main.cpp) qt_add_resources(SOURCES example.qrc) qt_add_executable(myapp ${SOURCES})
Target variant, using immediate resources:
qt_add_executable(myapp main.cpp) qt_add_resources(myapp "images" PREFIX "/images" FILES image1.png image2.png)
When adding multiple resources,
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.
另请参阅 qt_add_big_resources() .