AUTORCC.rst 1.6 KB

123456789101112131415161718192021222324252627282930313233343536373839
  1. AUTORCC
  2. -------
  3. Should the target be processed with autorcc (for Qt projects).
  4. ``AUTORCC`` is a boolean specifying whether CMake will handle
  5. the Qt ``rcc`` code generator automatically, i.e. without having to use
  6. the :module:`QT4_ADD_RESOURCES() <FindQt4>` or ``QT5_ADD_RESOURCES()``
  7. macro. Currently Qt4 and Qt5 are supported.
  8. When this property is ``ON``, CMake will handle ``.qrc`` files added
  9. as target sources at build time and invoke ``rcc`` accordingly.
  10. This property is initialized by the value of the :variable:`CMAKE_AUTORCC`
  11. variable if it is set when a target is created.
  12. By default :prop_tgt:`AUTORCC` is processed inside a
  13. :command:`custom command <add_custom_command>`.
  14. If the ``.qrc`` file is :prop_sf:`GENERATED` though, a
  15. :command:`custom target <add_custom_target>` is used instead.
  16. Additional command line options for rcc can be set via the
  17. :prop_sf:`AUTORCC_OPTIONS` source file property on the ``.qrc`` file.
  18. The global property :prop_gbl:`AUTOGEN_TARGETS_FOLDER` can be used to group
  19. the autorcc targets together in an IDE, e.g. in MSVS.
  20. The global property :prop_gbl:`AUTOGEN_SOURCE_GROUP` can be used to group
  21. files generated by :prop_tgt:`AUTORCC` together in an IDE, e.g. in MSVS.
  22. When there are multiple ``.qrc`` files with the same name, CMake will
  23. generate unspecified unique names for ``rcc``. Therefore if
  24. ``Q_INIT_RESOURCE()`` or ``Q_CLEANUP_RESOURCE()`` need to be used the
  25. ``.qrc`` file name must be unique.
  26. Source files can be excluded from :prop_tgt:`AUTORCC` processing by
  27. enabling :prop_sf:`SKIP_AUTORCC` or the broader :prop_sf:`SKIP_AUTOGEN`.
  28. See the :manual:`cmake-qt(7)` manual for more information on using CMake
  29. with Qt.