source_group

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

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

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

TREE

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

PREFIX

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

FILES

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

REGULAR_EXPRESSION

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

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

Имя <name> группы и <prefix> аргумент могут содержать обратные слэши для указания подгрупп:

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

Для обеспечения обратной совместимости, сокращённый синтаксис

source_group(<name> <regex>)

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

source_group(<name> REGULAR_EXPRESSION <regex>)