|
|
|
AUTORCC
|
|
|
|
-------
|
|
|
|
|
|
|
|
Should the target be processed with auto-rcc (for Qt projects).
|
|
|
|
|
|
|
|
:prop_tgt:`AUTORCC` is a boolean specifying whether CMake will handle
|
|
|
|
the Qt ``rcc`` code generator automatically, i.e. without having to use
|
|
|
|
commands like :module:`QT4_ADD_RESOURCES() <FindQt4>`, ``QT5_ADD_RESOURCES()``,
|
|
|
|
etc. Currently, Qt versions 4 to 6 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 :variable:`CMAKE_AUTORCC`
|
|
|
|
variable if it is set when a target is created.
|
|
|
|
|
|
|
|
By default :prop_tgt:`AUTORCC` is processed by a
|
|
|
|
:command:`custom command <add_custom_command>`.
|
|
|
|
If the ``.qrc`` file is :prop_sf:`GENERATED`, a
|
|
|
|
:command:`custom target <add_custom_target>` is used instead.
|
|
|
|
|
|
|
|
When there are multiple ``.qrc`` files with the same name, CMake will
|
|
|
|
generate unspecified unique output file names for ``rcc``. Therefore, if
|
|
|
|
``Q_INIT_RESOURCE()`` or ``Q_CLEANUP_RESOURCE()`` need to be used, the
|
|
|
|
``.qrc`` file name must be unique.
|
|
|
|
|
|
|
|
|
|
|
|
Modifiers
|
|
|
|
^^^^^^^^^
|
|
|
|
|
|
|
|
:prop_tgt:`AUTORCC_EXECUTABLE`:
|
|
|
|
The ``rcc`` executable will be detected automatically, but can be forced to
|
|
|
|
a certain binary by setting this target property.
|
|
|
|
|
|
|
|
:prop_tgt:`AUTORCC_OPTIONS`:
|
|
|
|
Additional command line options for ``rcc`` can be set via this target
|
|
|
|
property. The corresponding :prop_sf:`AUTORCC_OPTIONS` source file property
|
|
|
|
can be used to specify options to be applied only to a specific ``.qrc`` file.
|
|
|
|
|
|
|
|
:prop_sf:`SKIP_AUTORCC`:
|
|
|
|
``.qrc`` files can be excluded from :prop_tgt:`AUTORCC` processing by
|
|
|
|
setting this source file property.
|
|
|
|
|
|
|
|
:prop_sf:`SKIP_AUTOGEN`:
|
|
|
|
Source files can be excluded from :prop_tgt:`AUTOMOC`,
|
|
|
|
:prop_tgt:`AUTOUIC` and :prop_tgt:`AUTORCC` processing by
|
|
|
|
setting this source file property.
|
|
|
|
|
|
|
|
:prop_gbl:`AUTOGEN_SOURCE_GROUP`:
|
|
|
|
This global property can be used to group files generated by
|
|
|
|
:prop_tgt:`AUTOMOC` or :prop_tgt:`AUTORCC` together in an IDE, e.g. in MSVS.
|
|
|
|
|
|
|
|
:prop_gbl:`AUTOGEN_TARGETS_FOLDER`:
|
|
|
|
This global property can be used to group :prop_tgt:`AUTOMOC`,
|
|
|
|
:prop_tgt:`AUTOUIC` and :prop_tgt:`AUTORCC` targets together in an IDE,
|
|
|
|
e.g. in MSVS.
|
|
|
|
|
|
|
|
:variable:`CMAKE_GLOBAL_AUTORCC_TARGET`:
|
|
|
|
A global ``autorcc`` target that depends on all :prop_tgt:`AUTORCC` targets
|
|
|
|
in the project will be generated when this variable is ``ON``.
|
|
|
|
|
|
|
|
See the :manual:`cmake-qt(7)` manual for more information on using CMake
|
|
|
|
with Qt.
|