AUTOMOC

Необходимо ли обрабатывать целевой объект с помощью авто-moc (для проектов Qt).

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

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

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

Обработка файлов заголовков

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

• Все файлы заголовков в исходных файлах целевого объекта добавляются в список сканирования.

• Для всех файлов исходного кода C++ <source_base>.<source_extension> в исходных файлах целевого объекта CMake ищет

  • файл заголовка с тем же базовым именем (<source_base>.<header_extention>) и
  • приватный файл заголовка с тем же базовым именем и суффиксом _p (<source_base>_p.<header_extention>)

  и добавляет их в список сканирования.

Во время сборки CMake сканирует каждый неизвестный или измененный файл заголовка из списка и ищет

• макрос Qt из AUTOMOC_MACRO_NAMES,
• дополнительные зависимости файлов из аргумента FILE макроса Q_PLUGIN_METADATA и
• дополнительные зависимости файлов, обнаруженные фильтрами, определенными в AUTOMOC_DEPEND_FILTERS.

Если макрос Qt найден, то файл заголовка будет скомпилирован moc в выходной файл moc_<base_name>.cpp. Полный путь к выходному файлу описан в разделе Расположение выходного файла.

Файл заголовка будет moc скомпилирован повторно, если изменится файл из дополнительных зависимостей файлов.

Выходные файлы заголовка moc moc_<base_name>.cpp могут быть включены в исходные файлы. Более подробная информация об этом содержится в разделе Включение файлов заголовков moc в исходные файлы.

Обработка файлов исходного кода

Во время сборки CMake сканирует каждый неизвестный или измененный файл исходного кода C++ из исходных файлов целевого объекта в поисках

• макроса Qt из AUTOMOC_MACRO_NAMES,
• включений файлов заголовков moc (см. Включение файлов заголовков moc в исходные файлы),
• дополнительных зависимостей файлов из аргумента FILE макроса Q_PLUGIN_METADATA и
• дополнительных зависимостей файлов, обнаруженных фильтрами, определенными в AUTOMOC_DEPEND_FILTERS.

Если макрос Qt найден, то файл исходного кода C++ <base>.<source_extension> также должен содержать оператор включения

#include <<base>.moc> // or
#include "<base>.moc"

Затем исходный файл будет скомпилирован moc в выходной файл <base>.moc. Описание полного пути к выходному файлу находится в разделе Расположение выходного файла.

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

Включение файлов заголовков moc в исходные файлы

Файл исходного кода может включать выходной файл moc файла заголовка <header_base>.<header_extension> с помощью оператора включения следующего вида

#include <moc_<header_base>.cpp> // or
#include "moc_<header_base>.cpp"

Если выходной файл moc файла заголовка включен исходным файлом, он будет сгенерирован в другом расположении, чем если бы он не был включен. Это описано в разделе Расположение выходного файла.

Расположение выходного файла

Включенные выходные файлы moc

Выходные файлы moc , включенные в исходный файл, будут сгенерированы в

• <AUTOGEN_BUILD_DIR>/include для генераторов с одной конфигурацией или в
• <AUTOGEN_BUILD_DIR>/include_<CONFIG> для генераторов multi configuration.

Где <AUTOGEN_BUILD_DIR> — значение свойства целевого объекта AUTOGEN_BUILD_DIR.

Директория включения автоматически добавляется в INCLUDE_DIRECTORIES целевого объекта.

Не включенные выходные файлы moc

Выходные файлы moc , которые не включены в исходный файл, будут сгенерированы в

• <AUTOGEN_BUILD_DIR>/<SOURCE_DIR_CHECKSUM> для генераторов с одной конфигурацией или в,
• <AUTOGEN_BUILD_DIR>/include_<CONFIG>/<SOURCE_DIR_CHECKSUM> для генераторов multi configuration.

Где <SOURCE_DIR_CHECKSUM> — контрольная сумма, вычисленная из относительного пути родительской директории файла moc ввода. Эта схема позволяет иметь файлы moc ввода с одинаковым именем в разных директориях.

Все не включенные выходные файлы moc будут автоматически включены сгенерированным файлом CMake

• <AUTOGEN_BUILD_DIR>/mocs_compilation.cpp, или
• <AUTOGEN_BUILD_DIR>/mocs_compilation_$<CONFIG>.cpp,

который добавляется в исходные файлы целевого объекта.

Обнаружение версии Qt

Для AUTOMOC активированных целевых объектов необходимо знать основную и дополнительную версии Qt, с которыми они работают. Основная версия обычно предоставляется свойством INTERFACE_QT_MAJOR_VERSION библиотеки Qt[456]Core, к которой связан целевой объект. Для определения дополнительной версии CMake создает список доступных версий Qt из

• Qt6Core_VERSION_MAJOR и Qt6Core_VERSION_MINOR переменных (обычно устанавливаются find_package(Qt6...))
• Qt6Core_VERSION_MAJOR и Qt6Core_VERSION_MINOR свойств директорий
• Qt5Core_VERSION_MAJOR и Qt5Core_VERSION_MINOR переменных (обычно устанавливаются find_package(Qt5...))
• Qt5Core_VERSION_MAJOR и Qt5Core_VERSION_MINOR свойств директорий
• QT_VERSION_MAJOR и QT_VERSION_MINOR переменных (обычно устанавливаются find_package(Qt4...))
• QT_VERSION_MAJOR и QT_VERSION_MINOR свойств директорий

в контексте вызова add_executable() или add_library().

Предполагается, что INTERFACE_QT_MAJOR_VERSION является допустимым числом; берется первая запись в списке с соответствующей основной версией. Если не найдена соответствующая основная версия, генерируется ошибка. Если INTERFACE_QT_MAJOR_VERSION не является допустимым числом, берется первая запись в списке.

Вызов find_package(Qt[456]...) устанавливает переменные QT/Qt[56]Core_VERSION_MAJOR/MINOR. Если вызов находится в другом контексте, чем вызов add_executable() или add_library(), например, в функции, то переменные версии могут быть недоступны для AUTOMOC активированного целевого объекта. В этом случае переменные версии можно передать из find_package(Qt[456]...) вызывающего контекста в вызывающий контекст add_executable() или add_library() в качестве свойств директории. Следующий пример Qt5 демонстрирует процедуру.

function (add_qt5_client)
  find_package(Qt5 REQUIRED QUIET COMPONENTS Core Widgets)
  ...
  set_property(DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}"
    PROPERTY Qt5Core_VERSION_MAJOR "${Qt5Core_VERSION_MAJOR}")
  set_property(DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}"
    PROPERTY Qt5Core_VERSION_MINOR "${Qt5Core_VERSION_MAJOR}")
  ...
endfunction ()
...
add_qt5_client()
add_executable(myTarget main.cpp)
target_link_libraries(myTarget Qt5::QtWidgets)
set_property(TARGET myTarget PROPERTY AUTOMOC ON)

Модификаторы

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

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

AUTOMOC_MACRO_NAMES: Этот список имен макросов Qt может быть расширен для поиска дополнительных макросов в заголовках и исходных файлах.

AUTOMOC_DEPEND_FILTERS: Имена файлов зависимостей moc могут быть извлечены из заголовков или исходных файлов путем определения фильтров имен файлов в этом свойстве целевого объекта.

AUTOMOC_COMPILER_PREDEFINES: Предопределения компилятора для moc записываются в файл moc_predefs.h . Генерация этого файла может быть включена или отключена в этом свойстве целевого объекта.

SKIP_AUTOMOC: Источники и заголовки могут быть исключены из обработки AUTOMOC путем установки этого свойства файла-источника.

SKIP_AUTOGEN: Файлы-источники могут быть исключены из AUTOMOC, AUTOUIC и AUTORCC обработки путем установки этого свойства файла-источника.

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

AUTOGEN_TARGETS_FOLDER: Это глобальное свойство можно использовать для группирования AUTOMOC, AUTOUIC и AUTORCC целей вместе в IDE, например, в MSVS.

CMAKE_GLOBAL_AUTOGEN_TARGET: Глобальная autogen цель, которая зависит от всех AUTOMOC или AUTOUIC сгенерированных целей <ORIGIN>_autogen в проекте, будет сгенерирована, когда эта переменная ON.

AUTOGEN_PARALLEL: Это свойство цели управляет количеством moc или uic процессов, которые запускаются параллельно во время сборки.

AUTOGEN_COMMAND_LINE_LENGTH_MAX: Это свойство цели управляет пределом, при котором следует использовать файлы ответов для moc или uic процессов в Windows.

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