source_group

Определите группировку для исходных файлов в процессе генерации проекта IDE. Существуют две различные подписи для создания групп исходных файлов.

source_group(<name> [FILES <src>...] [REGULAR_EXPRESSION <regex>])
source_group(TREE <root> [PREFIX <prefix>] [FILES <src>...])

Определяет группу, в которую будут помещены исходные файлы в файлы проекта. Это предназначено для настройки вкладок файлов в Visual Studio. Группа ограничена каталогом, в котором вызывается команда, и применяется к исходным файлам, созданным в этом каталоге.

Доступны следующие параметры:

TREE

Добавлена в версии 3.8.

CMake автоматически обнаруживает из <src> путей файлов исходные группы, которые нужно создать, чтобы сохранить структуру групп исходных файлов аналогично фактической структуре файлов и каталогов в проекте. Пути <src> файлов будут усечены, чтобы относиться к <root>. Команда завершается ошибкой, если пути в src не начинаются с root.

PREFIX

Добавлена в версии 3.8.

Группа исходных файлов и файлы, расположенные непосредственно в <root> пути, будут размещены в <prefix> группах исходных файлов.

FILES

Любой явно указанный исходный файл будет помещен в группу <name>. Относительные пути интерпретируются относительно текущего каталога исходных файлов.

REGULAR_EXPRESSION

Любой исходный файл, имя которого соответствует регулярному выражению, будет помещен в группу <name>.

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

Имя <name> группы и <prefix> аргумент могут содержать косые черты или обратные косые черты для указания подгрупп. Обратные косые черты необходимо экранировать соответствующим образом:

source_group(base/subdir ...)
source_group(outer\\inner ...)
source_group(TREE <root> PREFIX sources\\inc ...)

Для обратной совместимости короткая подпись

source_group(<name> <regex>)

эквивалентна

source_group(<name> REGULAR_EXPRESSION <regex>)