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`中的路径不以`root`开头,则该命令失败。 PREFIX
版本 3.8 新增。
源组和直接位于`
`路径中的文件将被放置在` `源组中。 FILES
任何明确指定的源文件将被放置在`
`组中。相对路径根据当前源目录进行解释。 REGULAR_EXPRESSION
任何名称与正则表达式匹配的源文件将被放置在`
`组中。
如果一个源文件匹配多个组,则如果存在的话,将优先选择最后一个明确列出该文件的组(通过`FILES`)。如果没有组明确列出该文件,则将优先选择最后一个其正则表达式匹配该文件的组。
组的`
source_group(base/subdir ...)
source_group(outer\\inner ...)
source_group(TREE <root> PREFIX sources\\inc ...)
版本 3.18 新增: 允许使用正斜杠(`/`)来指定子组。
为了向后兼容,简写签名
source_group(<name> <regex>)
等价于
source_group(<name> REGULAR_EXPRESSION <regex>)