find_package()函数

引言

一个库文件已经安装但是在程序调用时候，报错找不到库文件API。

LAPACK库已经是安装过的而且是安装在系统文件里面的/usr/local/lib,但是调用的时候就是找不到。

1.find_package用法

find_package(LAPACK REQUIRED)

如果找到LAPACK库就把头文件（应该可以这么说吧）路径和库文件路径赋值给下面两个语句中的 ${LAPACK_INCLUDE_DIRS}、 ${LAPACK_LIBRARIES}。

include_directories(
  include
 ${catkin_INCLUDE_DIRS}
 ${OpenCV_INCLUDE_DIRS}
 ${TooN_INCLUDE_DIRS}
 ${spdlog_INCLUDE_DIRS}
 ${LAPACK_INCLUDE_DIRS}
)

target_link_libraries(${PROJECT_NAME}
  ${catkin_LIBRARIES}
  ${OpenCV_LIBRARIES}
  ${LAPACK_LIBRARIES}
)

2.find_package原理

首先，cmake本身不提供任何搜索库的便捷方法，所有搜索库并给变量赋值的操作必须由cmake代码完成，比如FindXXX.cmake和XXXConfig.cmake。只不过，库的作者通常会提供这两个文件，以方便使用者调用。
find_package采用两种模式搜索库：

1. Module模式：搜索CMAKE_MODULE_PATH指定路径下的FindXXX.cmake文件，执行该文件从而找到XXX库。其中，具体查找库并给XXX_INCLUDE_DIRS和XXX_LIBRARIES两个变量赋值的操作由FindXXX.cmake模块完成（先搜索当前项目里面的Module文件夹里面提供的FindXXX.cmake，然后再搜索系统路径/usr/local/share/cmake-x.y/Modules/FindXXX.cmake）
2. Config模式：搜索XXX_DIR指定路径下的XXXConfig.cmake文件，执行该文件从而找到XXX库。其中具体查找库并给XXX_INCLUDE_DIRS和XXX_LIBRARIES两个变量赋值的操作由XXXConfig.cmake模块完成。
3. 对于可能没有***.cmake和***Config.cmake的库文件，可以直接找到其头文件和库文件所在文件夹，直接进行路径赋值：
   SET(LAPACK_DIR /usr/local/lib/) SET(LAPACK_INCLUDE_DIRS /usr/local/include) SET(LAPACK_LIBRARIES /usr/local/lib)

两种模式看起来似乎差不多，不过cmake默认采取Module模式，如果Module模式未找到库，才会采取Config模式。如果XXX_DIR路径下找不到XXXConfig.cmake文件，则会找/usr/local/lib/cmake/XXX/中的XXXConfig.cmake文件。总之，Config模式是一个备选策略。通常，库安装时会拷贝一份XXXConfig.cmake到系统目录中，因此在没有显式指定搜索路径时也可以顺利找到。

如果找到这个包，则可以通过在工程的顶层目录中的CMakeLists.txt 文件添加 include_directories(XXX_INCLUDE_DIRS) 来包含库的头文件，添加target_link_libraries(XXX_LIBRARIES)命令将源文件与库文件链接起来。

3.A required library with LAPACK API not found. 错误解决

我这里就比较坑了，库文件是已经安装了的，而且是安装到系统目录里面的,但没办法找到库文件，是官方给的FindLAPACK.cmake文件有误，$sudo su $rm FindLAPACK.cmake 删除Module模式里面的***.cmake文件，因为如果不删除其他地方不管你怎么改，CmakLists.txt如何链接都是枉子的，亲身踩坑！然后启用Config模式看看里面的XXXConfig.cmake能否正常工作。完整步骤如下：

#删除系统文件需要权限
sudu su
#找到报错路径/usr/local/share/cmake-x.y/Modules/删除FindXXX.cmake
rm FindXXX.cmake
#在项目文件Cmakelists.txt文件中添加如下一句，指定路径，指定之前先查看路径下是否有XXXConfig.cmake
SET(LAPACK_DIR  /usr/local/lib/cmake/lapack-3.8.0)
#OK！

4.添加findpackage查询路径

LIST(APPEND CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/modules)

CMakeLists.txt知识点很多慢慢积累吧。