如何在CMake项目中通过CPM引入并构建libgphoto2？

针对libgphoto2这类非CMake构建的autotools项目，我们需要通过CPM下载源码+ExternalProject手动构建的方式集成，同时处理跨平台（Linux/macOS）的构建逻辑，以下是完整可运行的CMake配置及说明：

修正后的CMakeLists.txt #

cmake_minimum_required(VERSION 3.14)
project(YourProjectName CXX)

# 导入CPM模块
include(cmake/CPM.cmake)

# 1. 先安装libgphoto2依赖的libusb（libusb支持CMake，可直接用CPM处理）
CPMAddPackage(
  NAME libusb
  GIT_REPOSITORY https://github.com/libusb/libusb.git
  GIT_TAG v1.0.27
)

# 2. 下载libgphoto2源码（仅下载，不自动构建）
CPMAddPackage(
  NAME libgphoto2
  GIT_REPOSITORY https://github.com/gphoto/libgphoto2.git
  GIT_TAG libgphoto2_2_5_31 # 替换为你需要的版本
  DOWNLOAD_ONLY YES
)

if(libgphoto2_ADDED)
  # 3. 用ExternalProject执行autotools构建流程
  include(ExternalProject)
  ExternalProject_Add(
    libgphoto2_build
    SOURCE_DIR ${libgphoto2_SOURCE_DIR}
    # 生成configure脚本并指定安装路径到CPM构建目录内
    CONFIGURE_COMMAND ${libgphoto2_SOURCE_DIR}/autogen.sh --prefix=${libgphoto2_BINARY_DIR}/install --disable-dependency-tracking
    # 并行编译
    BUILD_COMMAND make -j${CMAKE_BUILD_PARALLEL_LEVEL}
    INSTALL_COMMAND make install
    BUILD_IN_SOURCE NO
  )

  # 4. 导入构建好的库和头文件
  set(LIBGPHOTO2_INCLUDE_DIR ${libgphoto2_BINARY_DIR}/install/include)
  set(LIBGPHOTO2_LIBRARY ${libgphoto2_BINARY_DIR}/install/lib/libgphoto2${CMAKE_SHARED_LIBRARY_SUFFIX})
  set(LIBGPHOTO2_PORT_LIBRARY ${libgphoto2_BINARY_DIR}/install/lib/libgphoto2_port${CMAKE_SHARED_LIBRARY_SUFFIX})

  # 创建CMake导入目标，方便后续链接
  add_library(libgphoto2::libgphoto2 SHARED IMPORTED)
  set_target_properties(libgphoto2::libgphoto2 PROPERTIES
    IMPORTED_LOCATION ${LIBGPHOTO2_LIBRARY}
    INTERFACE_INCLUDE_DIRECTORIES ${LIBGPHOTO2_INCLUDE_DIR}
  )
  add_dependencies(libgphoto2::libgphoto2 libgphoto2_build)

  add_library(libgphoto2::libgphoto2_port SHARED IMPORTED)
  set_target_properties(libgphoto2::libgphoto2_port PROPERTIES
    IMPORTED_LOCATION ${LIBGPHOTO2_PORT_LIBRARY}
    INTERFACE_INCLUDE_DIRECTORIES ${LIBGPHOTO2_INCLUDE_DIR}
  )
  add_dependencies(libgphoto2::libgphoto2_port libgphoto2_build)
endif()

# 5. 关联你的项目目标
add_executable(your_executable src/main.cpp)
target_link_libraries(your_executable PRIVATE 
  libgphoto2::libgphoto2 
  libgphoto2::libgphoto2_port 
  libusb::libusb
)

关键逻辑说明 #

1. 头文件缺失问题解决：通过将libgphoto2的安装目录install/include加入头文件搜索路径，确保<gphoto2/gphoto2-port.h>这类嵌套引用能被正确找到。
2. autotools构建适配：使用autogen.sh生成configure脚本（git克隆的源码无预生成configure），并通过--prefix指定安装路径到CPM的构建目录内，避免污染系统环境。
3. 跨平台兼容：
   • Linux：构建容器时需安装autotools依赖（autoconf/automake/libtool）
   • macOS：本地构建可通过brew安装依赖，容器构建建议使用Ubuntu镜像统一环境

容器化构建示例（Dockerfile） #

FROM ubuntu:22.04

# 安装构建依赖
RUN apt-get update && apt-get install -y \
  build-essential \
  cmake \
  autoconf \
  automake \
  libtool \
  libusb-1.0-0-dev \
  git

# 复制项目代码并构建
COPY . /app
WORKDIR /app/build
RUN cmake .. && make -j$(nproc)

# 设置运行命令
CMD ["./your_executable"]

内容的提问来源于stack exchange，提问作者Benjamin Danlos