如何在 cmake 中添加库路径？

Question

我的项目中有 2 个文件夹“inc”和“lib”，它们分别具有标头和静态库。 我如何告诉 cmake 分别使用这 2 个目录进行包含和链接？

Answer 1

最简单的方法是添加

include_directories(${CMAKE_SOURCE_DIR}/inc)
link_directories(${CMAKE_SOURCE_DIR}/lib)

add_executable(foo ${FOO_SRCS})
target_link_libraries(foo bar) # libbar.so is found in ${CMAKE_SOURCE_DIR}/lib

不向每个编译器调用添加-I and -L标志的现代 CMake 版本将使用导入的库：

add_library(bar SHARED IMPORTED) # or STATIC instead of SHARED
set_target_properties(bar PROPERTIES
  IMPORTED_LOCATION "${CMAKE_SOURCE_DIR}/lib/libbar.so"
  INTERFACE_INCLUDE_DIRECTORIES "${CMAKE_SOURCE_DIR}/include/libbar"
)

set(FOO_SRCS "foo.cpp")
add_executable(foo ${FOO_SRCS})
target_link_libraries(foo bar) # also adds the required include path

如果设置INTERFACE_INCLUDE_DIRECTORIES不添加路径，则旧版本的 CMake 还允许您使用target_include_directories(bar PUBLIC /path/to/include) 。 但是，这不再适用于 CMake 3.6 或更高版本。

Answer 2

使用 link_directories 可能会失败，然后添加每个静态库，如下所示：

target_link_libraries(foo /path_to_static_library/libbar.a)

Answer 3

您最好使用find_library命令而不是 link_directories。 具体来说有两种方式：

1. 在命令中指定路径

   find_library(NAMES gtest PATHS path1 path2 ... pathN)

2. 设置变量 CMAKE_LIBRARY_PATH

   设置（CMAKE_LIBRARY_PATH path1 path2）
   find_library(NAMES gtest)

原因是流动的：

注意 此命令很少需要，应避免在有其他选择的情况下使用。 尽可能将完整的绝对路径传递给库，因为这可确保始终链接正确的库。 find_library() 命令提供完整路径，通常可以直接用于调用 target_link_libraries()。 可能需要库搜索路径的情况包括： 像 Xcode 这样的项目生成器，用户可以在构建时切换目标架构，但不能使用库的完整路径，因为它只提供一种架构（即它不是通用二进制）。

库本身可能有其他私有库依赖项，这些依赖项希望通过 RPATH 机制找到，但一些链接器无法完全解码这些路径（例如，由于 $ORIGIN 之类的东西的存在）。

如果必须提供库搜索路径，请尽可能使用 target_link_directories() 命令而不是 link_directories() 命令来本地化效果。 特定于目标的命令还可以控制搜索目录如何传播到其他相关目标。