菜鸟笔记
提升您的技术认知

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()