如何创建可重定位CMake包以正确处理依赖目标头文件路径？

核心问题出在直接使用${ALSA_INCLUDE_DIRS}硬编码路径上，正确的做法是利用CMake的**导入目标（Imported Target）**机制，让依赖路径在用户机器上动态解析，而非固定死本机路径。以下是完整的实现步骤和代码示例：

一、正确的CMakeLists.txt写法 #

1. 基础项目配置 #

cmake_minimum_required(VERSION 3.16)
project(fooLib VERSION 1.0.0 LANGUAGES C)

# 强制使用现代CMake行为，避免旧版本兼容问题
cmake_policy(SET CMP0076 NEW)
cmake_policy(SET CMP0022 NEW)

2. 查找ALSA依赖（关键：使用导入目标） #

Ubuntu 22.04自带的FindALSA.cmake会自动生成ALSA::ALSA导入目标，无需手动处理头文件和库路径：

find_package(ALSA REQUIRED)

注：如果遇到旧版CMake未生成ALSA::ALSA的情况，可手动补全导入目标：

if(NOT TARGET ALSA::ALSA)
    add_library(ALSA::ALSA UNKNOWN IMPORTED)
    set_target_properties(ALSA::ALSA PROPERTIES
        IMPORTED_LOCATION "${ALSA_LIBRARY}"
        INTERFACE_INCLUDE_DIRECTORIES "${ALSA_INCLUDE_DIRS}"
    )
endif()

3. 定义库目标并关联依赖 #

add_library(fooLib src/foo.c)

# 设置自身头文件路径（区分构建时和安装后的路径）
target_include_directories(fooLib
    PUBLIC
        $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/include>  # 本地构建时用的路径
        $<INSTALL_INTERFACE:include>                      # 安装后用户项目用的路径
)

# 关联ALSA依赖：用导入目标替代直接写路径，依赖会自动传递给用户项目
target_link_libraries(fooLib PUBLIC ALSA::ALSA)

# 可选：设置C标准和编译选项
target_compile_features(fooLib PRIVATE c_std_99)
target_compile_options(fooLib PRIVATE -Wall -Wextra)

4. 配置安装与包导出（生成可重定位包核心） #

# 安装库文件、头文件
install(TARGETS fooLib
    EXPORT fooLibTargets
    LIBRARY DESTINATION lib
    ARCHIVE DESTINATION lib
    RUNTIME DESTINATION bin
    INCLUDES DESTINATION include
)
install(DIRECTORY include/ DESTINATION include)

# 导出Targets文件（用户项目导入时会用到）
install(EXPORT fooLibTargets
    FILE fooLibTargets.cmake
    NAMESPACE fooLib::
    DESTINATION lib/cmake/fooLib
)

# 生成包配置文件和版本文件
include(CMakePackageConfigHelpers)
configure_package_config_file(
    ${PROJECT_SOURCE_DIR}/cmake/fooLibConfig.cmake.in
    ${PROJECT_BINARY_DIR}/fooLibConfig.cmake
    INSTALL_DESTINATION lib/cmake/fooLib
)
write_basic_package_version_file(
    ${PROJECT_BINARY_DIR}/fooLibConfigVersion.cmake
    VERSION ${PROJECT_VERSION}
    COMPATIBILITY SameMajorVersion
)

# 安装配置文件和版本文件
install(FILES
    ${PROJECT_BINARY_DIR}/fooLibConfig.cmake
    ${PROJECT_BINARY_DIR}/fooLibConfigVersion.cmake
    DESTINATION lib/cmake/fooLib
)

二、配套的fooLibConfig.cmake.in模板 #

在项目根目录下创建cmake/fooLibConfig.cmake.in文件，内容如下：

@PACKAGE_INIT@

include("${CMAKE_CURRENT_LIST_DIR}/fooLibTargets.cmake")

check_required_components(fooLib)

三、构建与安装流程 #

# 创建构建目录
mkdir build && cd build
# 配置CMake（可自定义安装路径，比如/usr/local）
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local
# 编译安装
make -j$(nproc)
sudo make install

四、用户项目如何导入fooLib #

用户只需在自己的CMakeLists.txt中添加：

find_package(fooLib REQUIRED)
add_executable(myapp main.c)
target_link_libraries(myapp PRIVATE fooLib::fooLib)

CMake会自动处理fooLib的依赖，包括在用户机器上重新查找ALSA的正确路径，完全不会出现硬编码路径的问题。

为什么之前的做法会失败？ #

直接将${ALSA_INCLUDE_DIRS}加入target_include_directories(PUBLIC)时，CMake会把本机的/usr/include路径硬编码到生成的fooLibTargets.cmake中。而使用ALSA::ALSA导入目标时，这个目标的路径信息是用户机器执行find_package(ALSA)时动态生成的，不会绑定到开发者的本机路径，完美实现可重定位。

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