AUTORCCΒΆ
Should the target be processed with autorcc (for Qt projects).
AUTORCC
is a boolean specifying whether CMake will handle
the Qt rcc
code generator automatically, i.e. without having to use
the QT4_ADD_RESOURCES()
or QT5_ADD_RESOURCES()
macro. Currently Qt4 and Qt5 are supported.
When this property is ON
, CMake will handle .qrc
files added
as target sources at build time and invoke rcc
accordingly.
This property is initialized by the value of the CMAKE_AUTORCC
variable if it is set when a target is created.
By default AUTORCC
is processed inside a
custom command
.
If the .qrc
file is GENERATED
though, a
custom target
is used instead.
Additional command line options for rcc can be set via the
AUTORCC_OPTIONS
source file property on the .qrc
file.
The rcc
executable will be detected automatically, but can be forced to
a certain binary using the AUTORCC_EXECUTABLE
property.
The global property AUTOGEN_TARGETS_FOLDER
can be used to group
the autorcc targets together in an IDE, e.g. in MSVS.
The global property AUTOGEN_SOURCE_GROUP
can be used to group
files generated by AUTORCC
together in an IDE, e.g. in MSVS.
When there are multiple .qrc
files with the same name, CMake will
generate unspecified unique names for rcc
. Therefore if
Q_INIT_RESOURCE()
or Q_CLEANUP_RESOURCE()
need to be used the
.qrc
file name must be unique.
Source files can be excluded from AUTORCC
processing by
enabling SKIP_AUTORCC
or the broader SKIP_AUTOGEN
.
A global autorcc
target that depends on all AUTORCC
targets
in the project can be generated by enabling
CMAKE_GLOBAL_AUTORCC_TARGET
.
See the cmake-qt(7)
manual for more information on using CMake
with Qt.