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
等。
示例
- 查找系统库:
find_library(MY_LIBRARY_PATH NAMES mylibrary)
这个例子会查找名为 mylibrary 的库,并将找到的库路径存储在 MY_LIBRARY_PATH 变量中。如果库文件名是 libmylibrary.so、libmylibrary.a 或其他系统默认的变体,CMake 会自动找到它。
- 指定路径查找:
find_library(MY_LIBRARY_PATH NAMES mylibrary PATHS /usr/local/lib /opt/lib)
在这个例子中,CMake 会在 /usr/local/lib 和 /opt/lib 路径中查找 mylibrary 库。
- 设置查找选项:
find_library(MY_LIBRARY_PATH NAMES mylibrary PATHS /usr/local/lib NO_DEFAULT_PATH)
这个例子中,NO_DEFAULT_PATH 选项告诉 CMake 不要使用系统默认的路径进行查找,只在 /usr/local/lib 路径中查找 mylibrary。
- 查找特定版本的库:
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,你可以方便地找到库文件并将其路径用于链接或其他需要的地方。