CMake中的add_subdirectory命令用于将子目录添加到构建,其格式如下:
add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL] [SYSTEM])
source_dir指定源CMakeLists.txt和代码文件所在的目录。如果它是相对路径,则将相对于当前目录(典型用法)对其进行评估,但它也可能是绝对路径。binary_dir指定放置输出文件的目录。如果它是相对路径,则将相对于当前输出目录进行评估,但它也可能是绝对路径。如果未指定binary_dir,则将在扩展任何相对路径之前使用source_dir的值(典型用法).指定源目录下的CMakeLists.txt文件将在当前输入文件继续处理之前立即被CMake处理(The CMakeLists.txt file in the specified source directory will be processed immediately by CMake before processing in the current input file continues beyond this command)。
如果提供了EXCLUDE_FROM_ALL参数,则默认情况下,子目录中的target将不包括在父目录的ALL target中,并且将从IDE项目(project)文件中排除。用户必须在子目录中显式构建target。这适用于子目录包含有用但不是必须的项目的单独部分(separate part)(例如一组示例)的情况。通常,子目录应包含自己的project命令调用,以便在子目录中生成完整的构建系统(例如VS IDE解决方案文件)。注意,target间依赖关系取代此排除。如果父项目构建的target依赖于子目录中的target,则依赖对象target将包含在父项目构建系统中以满足依赖关系。
如果