find_package()的底层运行机制

487
0
2020年6月11日 11时58分

马斯克的龙飞船中的操作系统是Linux,软件工程使用的是C++,用GCC和GDB去调试代码,C++如此强大和灵活,所以有必要了解一下C++工程是如何make的.

 

我们在写CMakeLists.txt时候需要查找第三方库的头文件和库文件,通常直接是执行

 

find_package(xxx)

 

然后就会有对应的

 

${XXX_INCLUDE_DIRS}和${XXX_LIBRARIES}

 

如果find_package(xxx)失败的话,就不会生成这两个环境变量.

 

这里讲一下这两个环境变量是怎么产生的.

 

1 find_package的两种搜索库模式

Module模式:搜索CMAKE_MODULE_PATH指定路径下的FindXXX.cmake文件,执行该文件从而找到XXX库。其中,具体查找库并给XXX_INCLUDE_DIRS和XXX_LIBRARIES两个变量赋值的操作由FindXXX.cmake模块完成。

 

Config模式:搜索XXX_DIR指定路径下的XXXConfig.cmake文件,执行该文件从而找到XXX库。其中具体查找库并给XXX_INCLUDE_DIRS和XXX_LIBRARIES两个变量赋值的操作由XXXConfig.cmake模块完成。

 

2 CMakeLists.txt中常用的变量

CMAKE_BINARY_DIR

 

  PROJECT_BINARY_DIR 
  <projectname>_BINARY_DIR
  CMAKE_BINARY_DIR

 

这三个变量指代的内容是一致的,如果是 in source 编译,指的就是工程顶层目录,如果是 out-of-source 编译,指的是工程编译发生的目录。

 

CMAKE_MODULE_PATH

 

这个变量用来定义自己的 cmake 模块所在的路径。如果你的工程比较复杂,有可能会自己编写一些 cmake 模块,这些 cmake 模块是随你的工程发布的,为了让 cmake 在处理CMakeLists.txt 时找到这些模块,你需要通过 SET 指令,将自己的 cmake 模块路径设置一下。

 

比如

 

SET(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake)

 

这时候你就可以通过 INCLUDE 指令来调用自己的模块了。

 

CMAKE_SOURCE_DIR

 

 PROJECT_SOURCE_DIR
 <projectname>_SOURCE_DIR
 CMAKE_SOURCE_DIR

 

这三个变量指代的内容是一致的,不论采用何种编译方式,都是工程顶层目录。

 

也就是在 in source 编译时,他跟 CMAKE_BINARY_DIR 等变量一致。

 

PROJECT_SOURCE_DIR 跟其他指令稍有区别,现在,你可以理解为他们是一致的。

 

CMAKE_CURRENT_SOURCE_DIR

 

指的是当前处理的 CMakeLists.txt 所在的路径,比如上面我们提到的 src 子目录。

 

CMAKE_CURRRENT_BINARY_DIR

 

如果是 in-source 编译,它跟 MAKE_CURRENT_SOURCE_DIR 一致,如果是 out-of-source 编译,他指的是 target 编译目录。

 

使用我们上面提到的 ADD_SUBDIRECTORY(src bin)可以更改这个变量的值。

 

使用 SET(EXECUTABLE_OUTPUT_PATH <新路径>)并不会对这个变量造成影响,它仅仅修改了最终目标文件存放的路径。

 

CMAKE_CURRENT_LIST_FILE

 

输出调用这个变量的 CMakeLists.txt 的完整路径

 

CMAKE_CURRENT_LIST_LINE

 

输出这个变量所在的行

 

EXECUTABLE_OUTPUT_PATH 和 LIBRARY_OUTPUT_PATH

 

分别用来重新定义最终结果的存放目录,前面我们已经提到了这两个变量。

 

PROJECT_NAME

 

返回通过 PROJECT 指令定义的项目名称。

发表评论

后才能评论