AUTOMOC_DEPEND_FILTERS

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

Фильтры определяются как KEYWORD;REGULAR_EXPRESSION пары. Сначала содержимое файла ищется KEYWORD. Если оно найдено хотя бы один раз, тогда имена файлов извлекаются, последовательно ища REGULAR_EXPRESSION и беря первую группу совпадений.

Имя файла, найденное в первой группе совпадений, ищется

• сначала в окрестности исходного файла
• и впоследствии в каталогах включения целевого файла INCLUDE_DIRECTORIES.

Если какой-либо из извлечённых файлов изменяется, то файл moc для исходного файла перестраивается, даже если сам исходный файл не меняется.

Если любой из извлечённых файлов является GENERATED или если он не входит в источники целевого файла, то может потребоваться добавить его в зависимости целевого файла целевой файл <ORIGIN>_autogen. См. AUTOGEN_TARGET_DEPENDS для справки.

По умолчанию AUTOMOC_DEPEND_FILTERS инициализируется из CMAKE_AUTOMOC_DEPEND_FILTERS, который по умолчанию пуст.

Начиная с Qt 5.15.0 эта переменная игнорируется, так как moc может выводить правильные зависимости.

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

Пример 1

Файл заголовка my_class.hpp использует пользовательский макрос JSON_FILE_MACRO, который определён в другом файле заголовка macros.hpp. Мы хотим, чтобы файл moc файла my_class.hpp зависел от аргумента имени файла JSON_FILE_MACRO.

// my_class.hpp
class My_Class : public QObject
{
  Q_OBJECT
  JSON_FILE_MACRO ( "info.json" )
...
};

В CMakeLists.txt мы добавляем фильтр в CMAKE_AUTOMOC_DEPEND_FILTERS так:

list( APPEND CMAKE_AUTOMOC_DEPEND_FILTERS
  "JSON_FILE_MACRO"
  "[\n][ \t]*JSON_FILE_MACRO[ \t]*\\([ \t]*\"([^\"]+)\""
)

Мы предполагаем, что info.json является обычным (не GENERATED) файлом, который указан в источниках целевого файла. Поэтому нам не нужно добавлять его в AUTOGEN_TARGET_DEPENDS.

Пример 2

В целевом файле my_target файл заголовка complex_class.hpp использует пользовательский макрос JSON_BASED_CLASS, который определён в другом файле заголовка macros.hpp:

// macros.hpp
...
#define JSON_BASED_CLASS(name, json) \
class name : public QObject \
{ \
  Q_OBJECT \
  Q_PLUGIN_METADATA(IID "demo" FILE json) \
  name() {} \
};
...

// complex_class.hpp
#pragma once
JSON_BASED_CLASS(Complex_Class, "meta.json")
// end of file

Поскольку complex_class.hpp не содержит макрос Q_OBJECT, он будет пропущен AUTOMOC. Мы изменяем это, добавив JSON_BASED_CLASS в CMAKE_AUTOMOC_MACRO_NAMES:

list(APPEND CMAKE_AUTOMOC_MACRO_NAMES "JSON_BASED_CLASS")

Мы хотим, чтобы файл moc файла complex_class.hpp зависел от meta.json. Поэтому мы добавляем фильтр в CMAKE_AUTOMOC_DEPEND_FILTERS:

list(APPEND CMAKE_AUTOMOC_DEPEND_FILTERS
  "JSON_BASED_CLASS"
  "[\n^][ \t]*JSON_BASED_CLASS[ \t]*\\([^,]*,[ \t]*\"([^\"]+)\""
)

Кроме того, мы предполагаем, что meta.json является GENERATED, поэтому мы должны добавить его в AUTOGEN_TARGET_DEPENDS:

set_property(TARGET my_target APPEND PROPERTY AUTOGEN_TARGET_DEPENDS "meta.json")