cmake:用add_subdirectory()添加外部项目文件夹

一般情况下，我们的项目各个子项目都在一个总的项目根目录下，但有的时候，我们需要使用外部的文件夹，怎么办呢？
add_subdirectory命令，可以将指定的文件夹加到build任务列表中。下面是将与当前项目平级的一个目录下的子目录用add_subdirectory命令加进来的CMakelists.txt脚本片段 ：

#定义CASSDK位置
if(NOT CASSDK_DIR)
	set( CASSDK_DIR ${CMAKE_SOURCE_DIR}/../cassdk)
endif()
if( IS_DIRECTORY ${CASSDK_DIR} )
	add_subdirectory( ${CASSDK_DIR}/cassdk )
else()
	message(FATAL_ERROR   "INVALID FOLDER 'CASSDK_DIR'=${CASSDK_DIR}" )
endif()

然后执行CMakeList.txt脚本时报错了：

CMake Error at CMakeLists.txt:35 (add_subdirectory):
add_subdirectory not given a binary directory but the given source
directory “J:/workspace/cassdk/cassdk” is not a subdirectory of
“J:/workspace/codemgr”. When specifying an out-of-tree source a binary
directory must be explicitly specified.

报错原因也很明确,因为要添加的这个文件夹不是当前项目的子目录。最后一句指明了方向：要指定一个外部的文件夹必须显式指定。
但怎么显式指定？
下面是add_subdirectory命令的官方说明：

原来add_subdirectory还有一个 binary_dir参数(一般这个参数用不到，所以从来没关注过),这个参数用来指定source_dir在输出文件夹中的位置，如果没有指定的时候，就用source_dir的值。
如果要添加外部文件夹，binary_dir就必须指定。所以上面的代码修改如下：

#定义CASSDK位置
if(NOT CASSDK_DIR)
	set( CASSDK_DIR ${CMAKE_SOURCE_DIR}/../cassdk)
endif()
if( IS_DIRECTORY ${CASSDK_DIR} )
	# 第二个cassdk.out参数用于指定外部文件夹在输出文件夹中的位置
	add_subdirectory( ${CASSDK_DIR}/cassdk cassdk.out)
else()
	message(FATAL_ERROR   "INVALID FOLDER 'CASSDK_DIR'=${CASSDK_DIR}" )
endif()

再执行CMakeList.txt正常通过，下图红框标出就是cassdk子目录下CMakeLists.txt的执行输出。

然后你可以发现在输出文件夹下多出一个名为cassdk.out的文件夹，就是第二个参数指定的值。

参考：
https://cmake.org/cmake/help/v3.1/command/add_subdirectory.html