AUTOMOC

Должен ли целевой объект обрабатываться с помощью automoc (для проектов Qt)?

AUTOMOC — это булево значение, определяющее, будет ли CMake обрабатывать Qt moc препроцессор автоматически, т. е. без необходимости использования макроса QT4_WRAP_CPP() или QT5_WRAP_CPP(). В настоящее время поддерживаются Qt4 и Qt5.

Когда эта свойство установлено ON, CMake будет сканировать заголовочные и исходные файлы во время сборки и вызывать moc соответствующим образом.

• Если обнаружено утверждение #include типа #include "moc_<basename>.cpp", ожидается появление макроса из AUTOMOC_MACRO_NAMES в заголовочном файле <basename>.h(xx). moc выполняется над заголовочным файлом для генерации moc_<basename>.cpp в директории <AUTOGEN_BUILD_DIR>/include, которая автоматически добавляется к каталогу включаемых файлов целевого объекта INCLUDE_DIRECTORIES. Это позволяет компилятору находить включённый moc_<basename>.cpp файл независимо от расположения исходного файла.

  • Для multi configuration generators каталог включаемых файлов — <AUTOGEN_BUILD_DIR>/include_<CONFIG>.
  • См. AUTOGEN_BUILD_DIR.
• Если обнаружено утверждение #include типа #include "<basename>.moc", ожидается появление макроса из AUTOMOC_MACRO_NAMES в исходном файле, и moc выполняется над самим исходным файлом.

• Заголовочные файлы, не включённые с помощью утверждения #include "moc_<basename>.cpp" типа #include "<basename>.moc", тем не менее, сканируются на наличие макроса из AUTOMOC_MACRO_NAMES. Результирующие файлы moc_<basename>.cpp генерируются в пользовательских каталогах и автоматически включаются в сгенерированный файл <AUTOGEN_BUILD_DIR>/mocs_compilation.cpp, который компилируется как часть целевого объекта.

  • Пользовательские каталоги с именами, основанными на контрольной сумме, помогают избежать коллизий имён для moc файлов с одинаковыми <basename>.
  • См. AUTOGEN_BUILD_DIR.
• Кроме того, заголовочные файлы с тем же базовым именем, что и исходный файл (например, <basename>.h) или _p, добавленное к базовому имени (например, <basename>_p.h), сканируются на наличие макроса из AUTOMOC_MACRO_NAMES. При его обнаружении moc также выполняется над этими файлами.
• AUTOMOC всегда проверяет несколько альтернативных расширений заголовочных файлов, таких как hpp, hxx, и т. д., при поиске заголовочных файлов.
• AUTOMOC ищет макрос Q_PLUGIN_METADATA и повторно запускает moc при изменении файла, указанного аргументом FILE макроса.

Это свойство инициализируется значением переменной CMAKE_AUTOMOC, если она установлена при создании целевого объекта.

Исполняемый файл moc будет обнаружен автоматически, но может быть принудительно задан с помощью свойства AUTOMOC_EXECUTABLE.

Дополнительные параметры командной строки для moc могут быть заданы через свойство AUTOMOC_MOC_OPTIONS.

Включив переменную CMAKE_AUTOMOC_RELAXED_MODE, можно смягчить правила поиска файлов, которые будут обработаны moc. Дополнительные сведения см. в документации по этой переменной.

Глобальное свойство AUTOGEN_TARGETS_FOLDER может использоваться для группировки целевых объектов automoc вместе в IDE, например, в MSVS.

Глобальное свойство AUTOGEN_SOURCE_GROUP может использоваться для группировки файлов, сгенерированных с помощью AUTOMOC, вместе в IDE, например, в MSVS.

Дополнительные имена макросов для поиска могут быть добавлены в AUTOMOC_MACRO_NAMES.

Дополнительные имена файлов зависимостей moc могут быть извлечены из исходного кода с помощью AUTOMOC_DEPEND_FILTERS.

Предопределения компилятора для moc записываются в файл moc_predefs.h, который управляется AUTOMOC_COMPILER_PREDEFINES.

Исходные файлы C++ могут быть исключены из обработки AUTOMOC, включив SKIP_AUTOMOC или более широкое SKIP_AUTOGEN.

Количество параллельных процессов moc может быть изменено путем установки AUTOGEN_PARALLEL.

Глобальный целевой объект autogen, зависящий от всех сгенерированных AUTOMOC целевых объектов <ORIGIN>_autogen в проекте, может быть сгенерирован, включив CMAKE_GLOBAL_AUTOGEN_TARGET.

Дополнительную информацию об использовании CMake с Qt см. в руководстве cmake-qt(7).