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", тем не менее, сканируются на наличие макроса из 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_MOC_OPTIONS.

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

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

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

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

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

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

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

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

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