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 будет иметь приоритет, если таковая имеется. Если ни одна группа явно не перечисляет файл, последняя группа, чьё регулярное выражение соответствует файлу, будет иметь приоритет.

Имя группы и аргумент <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>)