CMakeList 中 find_library 用法

在CMakeList中，有时需要 寻找 三方库，通常是使用 find_libaray 来进行查找的。

• find_library（名称1 [path1 path2 …]）
• 作用：用于查找库。
  VAR 创建名为的缓存条目以存储此命令的结果。
  如果找到了库，结果将存储在变量中，除非清除变量，否则将不会重复搜索。
  如果什么也没找到，结果将是-NOTFOUND。
  REQUIRED如果未找到任何内容，该选项将停止处理并显示一条错误消息，
  否则，下次使用相同的变量调 用find_library时，将再次尝试搜索。
• NAMES 为库指定一个或多个可能的名称。
• HINTS， PATHS 除了默认位置，还指定要搜索的目录。该子选项读取系统环境变量的路径。
• DOC 指定缓存条目的文档字符串。
• REQUIRED 如果未找到任何内容，则停止处理并显示错误消息。

---

Example1 ：
比如，我们经常会查找三方库。我们以VTK的中CMakeList 为例，如下
FindGLEW.cmake

find_library(GLEW_LIBRARY
  NAMES GLEW glew32
  DOC "glew library")

---

# ${CMAKE_CURRENT_LIST_DIR}/lib/Release 目录下，查找gpgjpeg库文件。
find_library(GPUJPEG_LIBRARY NAMES gpujpeg
             HINTS ${CMAKE_CURRENT_LIST_DIR}/lib/Release)
find_library(GPUJPEG_LIBRARY_RELEASE NAMES gpujpeg
             HINTS ${CMAKE_CURRENT_LIST_DIR}/lib/Release)
find_library(GPUJPEG_LIBRARY_DEBUG NAMES gpujpeg
             HINTS ${CMAKE_CURRENT_LIST_DIR}/lib/Debug)

# 将GPUJPEG_LIBRARY 这个变量设置在THIRDPARTY_LIBRARIES 中 
set(THIRDPARTY_LIBRARIES ${GPUJPEG_LIBRARY})
set(THIRDPARTY_LIBRARIES_RELEASE ${GPUJPEG_LIBRARY_RELEASE})
set(THIRDPARTY_LIBRARIES_DEBUG ${GPUJPEG_LIBRARY_DEBUG})

# 设置 TARGETS_GPUJPEG 路径文件，如果包含这个路径的文件，则包含这个*.cmake
set (TARGETS_GPUJPEG "${CMAKE_CURRENT_LIST_DIR}/cmake/gpujpeg-targets.cmake")
if(EXISTS ${TARGETS_GPUJPEG})
  include(${TARGETS_GPUJPEG})
endif()

---

参考：

• cmake - find_library 官方解释