CMake 脚本命令(Scripting Commands)之find_library

find_library

find_library 一般直接去查找依赖库文件，和find_package 不一样，find_package 找的是 .cmake 文件，而find_library 直接找 .so 或者 .a 文件。和find_path 一样，命令的执行结果会默认缓存到 CMakeCache.txt 中。

(1) 格式

find_library (
          <VAR>
          name | NAMES name1 [name2 ...] [NAMES_PER_DIR]
          [HINTS [path | ENV var]... ]
          [PATHS [path | ENV var]... ]
          [NO_CACHE]
          [REQUIRED]
)

命令说明

该命令用于查找 library 。创建一个高速缓存条目，或者如果指定了 NO_CACHE ，则创建一个普通变量，以 <VAR> 命名，以存储该命令的结果。

如果找到 library ，结果将存储在变量中，并且不会重复搜索，除非清除变量。

如果未找到任何内容，结果将为 <VAR>-NOTFOUND 。

选项解析：

<VAR>: 是存储库路径的变量名

name: 后面是要查找的库的名称

NAMES: 当为 NAMES 选项指定多个值时，此命令默认情况下将一次考虑一个名称并在每个目录中搜索该名称。 NAMES_PER_DIR 选项告诉该命令一次考虑一个目录并搜索其中的所有名称。

HINTS | PATHS:  HINTS，先搜索指定路径，后搜索系统路径 ；PATHS，先搜索系统路径，后搜索指定路径。

NO_CACHE：搜索结果将存储在普通变量中而不是缓存条目（即CMakeCache.txt）中。 REQUIRED：如果没有找到指定库文件，就出发错误提示，变量会设为 -NOTFOUND。

执行结果：

 查找成功时，会向变量中添加成功找到头文件的库文件（包含完整路径），如果在某个路径下查找多个头文件，只要查找到多个头文件中的某一个，也算执行成功。

(2) 举例

unset(LIBS CACHE)           # 清空变量LIB_DIR 
find_library(LIBS
    NAMES libopencv_core.so    # 前缀+库名+后缀
    HINTS /home/rookie/toolchain/opencv-3.4.10/build/lib
)
message("${LIBS}")    # /home/rookie/toolchain/opencv-3.4.10/build/lib/libopencv_core.so

unset(LIBS CACHE)          # 清空变量LIB_DIR
find_library(LIBS
    NAMES opencv_highgui      # 只有库名
    HINTS /home/rookie/toolchain/opencv-3.4.10/build/lib
)
message("${LIBS}")    # /home/rookie/toolchain/opencv-3.4.10/build/lib/libopencv_highgui.so

# 查找并存储名为 MyLibrary 的库
find_library(MY_LIBRARY MyLibrary)

# 如果找到，则打印库的完整路径
if(MY_LIBRARY)
    message("Library found at: ${MY_LIBRARY}")
else()
    message("Library not found")
endif()