cmake find_library指令详解

find_library 指令用于在指定的路径或系统中查找库文件，并设置一个变量来保存找到的库的路径。它在 CMake 配置过程中非常重要，尤其是当你需要链接外部库时。

语法

find_library(<VAR> name1 [path1 path2 ...] [options])

• VAR: 这是一个变量名，用于保存找到的库的路径。
• name1: 要查找的库的名称，不包括前缀（通常是 lib）和扩展名（例如 .so、.a、.dylib）。
• [path1 path2 …]: 可选的路径列表，在这些路径中查找库。如果没有提供，CMake 将在系统默认的库路径中查找。
• NO_DEFAULT_PATH、NO_CMAKE_ENVIRONMENT_PATH、NO_CMAKE_PATH、NO_SYSTEM_ENVIRONMENT_PATH
  等。

示例

1. 查找系统库:

find_library(MY_LIBRARY_PATH NAMES mylibrary)

这个例子会查找名为 mylibrary 的库，并将找到的库路径存储在 MY_LIBRARY_PATH 变量中。如果库文件名是 libmylibrary.so、libmylibrary.a 或其他系统默认的变体，CMake 会自动找到它。

2. 指定路径查找:

find_library(MY_LIBRARY_PATH NAMES mylibrary PATHS /usr/local/lib /opt/lib)

在这个例子中，CMake 会在 /usr/local/lib 和 /opt/lib 路径中查找 mylibrary 库。

3. 设置查找选项:

find_library(MY_LIBRARY_PATH NAMES mylibrary PATHS /usr/local/lib NO_DEFAULT_PATH)

这个例子中，NO_DEFAULT_PATH 选项告诉 CMake 不要使用系统默认的路径进行查找，只在 /usr/local/lib 路径中查找 mylibrary。

4. 查找特定版本的库:

find_library(MY_LIBRARY_PATH NAMES mylibrary PATHS /usr/local/lib)
if (MY_LIBRARY_PATH)
    message(STATUS "Found mylibrary at ${MY_LIBRARY_PATH}")
else()
    message(FATAL_ERROR "Could not find mylibrary")
endif()

这个例子中，find_library 查找 mylibrary 库并输出其路径。如果找不到库，则生成一个错误信息。

使用场景

• 库链接: 在构建过程中查找和链接外部库。
• 跨平台支持: 处理不同操作系统上库的路径问题。
• 自定义路径: 指定自定义库路径，特别是在非标准位置安装库时。

通过 find_library，你可以方便地找到库文件并将其路径用于链接或其他需要的地方。