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