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>)