如何在 CMake 中链接第三方库 (LibUSB)

Question

我正在尝试在项目中使用 LibUSB。但是，每当我尝试使用基本的 libUSB 函数时，都会出现以下错误：

...src/main/main.cpp.o: In function `main':
...src/main/main.cpp:10: undefined reference to `libusb_init'
...src/main/main.cpp:11: undefined reference to `libusb_set_debug'
collect2: error: ld returned 1 exit status

安装了 LibUSB-devel 包（我在 Fedora 22 上）并且我的 IDE KDevelop 找到并识别标头，一旦您添加了 import 语句，它就会提供 LibUSB 代码完成。我的 IDE 或 CMake（我的构建系统）中没有任何自定义包含行，所以我想知道我需要做什么才能让 CMake 找到 LibUSB 标头。

这是 的内容main.cpp，以防万一我搞砸了：

#include <iostream>
#include <libusb-1.0/libusb.h>

int main(int argc, char **argv) {
      libusb_init(NULL);
      libusb_set_debug(NULL, LIBUSB_LOG_LEVEL_WARNING);

      /*snip*/

      std::cout << "Hello, world! PTPID="  << std::endl;
      return 0;
}

以下是CMakeLists.txt：
../

cmake_minimum_required(VERSION 2.8.11)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")
set(CMAKE_BUILD_TYPE Debug)

project(aProjectThatHasHadIt'sNameObcured)
add_subdirectory(src)

.../src/cmakelists.txt 只是添加子目录

.../src/主/

add_executable(main main.cpp)

Answer 1

通常，要链接第三方库，您需要添加编译器将在其中查找头文件的包含目录以及链接器使用的库。
添加包含目录 use target_include_directories，添加要链接到目标 use 的库target_link_libraries。
对于 libUSB 和testLibUSB.cpp源文件，这将导致

add_executable(targetTestLibUSB testLibUSB.cpp)
target_include_directories(targetTestLibUSB ${LIBUSB_INCLUDE_DIR})
target_link_libraries(targetTestLibUSB ${LIBUSB_LIBRARY})

如果您有多个目标，您可能希望在定义任何目标之前使用include_directories和link_libraries。这些命令在设置后适用于项目的所有目标并节省大量重复

您可以为指定的路径LIBUSB_INCLUDE_DIR和LIBUSB_LIBRARY手工制作。但更灵活和便携的是使用 CMake 内置机制来查找头文件和库。
可以通过 搜索标题find_path和库find_library。
在你的情况下，这可能是

find_path(LIBUSB_INCLUDE_DIR
  NAMES libusb.h
  PATH_SUFFIXES "include" "libusb" "libusb-1.0")
find_library(LIBUSB_LIBRARY
  NAMES usb
  PATH_SUFFIXES "lib" "lib32" "lib64")

将PATH_SUFFIXES是可选的。如果您已将库安装在默认位置，CMake 会自动找到它。否则指定CMAKE_PREFIX_PATH，CMake 也会在那里寻找头文件和库。您可以通过将变量添加到 CMake GUI 或添加-DCMAKE_PREFIX_PATH=/path/to/add到您的 CMake 调用来指定变量。

一个常见的陷阱是不删除构建目录中的 CMakeCache.txt 文件。CMake 缓存LIBUSB_INCLUDE_DIRand的值LIBUSB_LIBRARY，如果您对前缀路径或搜索逻辑进行调整，它仍然不会重新评估变量值，而是坚持缓存的值。

Answer 2

从你的项目CMakeLists.txt文件来看，我并不清楚你如何尝试链接 libusb。我要做的方法如下：

target_link_libraries(project_name <other_dependencies> usb-1.0)

（为了澄清，我的意思是在其中添加可执行文件的 CMakeLIsts.txt 文件）

您尝试从中导入，<libusb-1.0/...>因此需要链接 usb-1.0 （链接器命令中始终省略该库！）

我使用的是 Fedora 23，也使用 KDevelop，并且不需要指定路径。特别是因为在我的系统上，前面答案中使用的所有环境变量无论如何都是 NULL。

要确认将来库的安装位置和方式，您可以执行以下操作： locate libusb | grep .so

希望这有点帮助。