CMake+Conan项目部署疑问：动态库复制与安装包构建最佳实践

核心思路 #

利用Conan生成的CMake导入变量/目标属性，结合CMake原生的install机制，精准获取并复制依赖的动态库文件，避免硬编码路径或依赖不可靠的目录扫描。

具体实现方案 #

1. 确保Conan生成正确的CMake导入文件 #

在你的conanfile.txt或conanfile.py中指定合适的生成器，让Conan暴露依赖的二进制路径：

# conanfile.txt 示例
[requires]
zlib/1.2.13

[generators]
cmake_find_package
cmake_paths

在CMakeLists.txt中导入Conan生成的路径配置，并查找依赖：

# 在项目初始化后调用
include(${CMAKE_BINARY_DIR}/conan_paths.cmake)
find_package(ZLIB REQUIRED)

此时Conan会自动定义ZLIB_BIN_DIR（通用路径）、ZLIB_BIN_DIR_DEBUG/ZLIB_BIN_DIR_RELEASE（分配置路径）等变量，直接指向依赖的动态库所在目录。

2. 用CMake目标属性精准获取动态库文件 #

如果使用conan_basic_setup(TARGETS)或cmake_find_package生成器，Conan会为依赖创建导入目标（比如ZLIB::zlib），通过目标属性可以直接拿到具体的动态库路径：

# 获取Release版动态库路径
get_target_property(ZLIB_DLL_RELEASE ZLIB::zlib IMPORTED_LOCATION_RELEASE)
# 获取Debug版动态库路径
get_target_property(ZLIB_DLL_DEBUG ZLIB::zlib IMPORTED_LOCATION_DEBUG)

# 安装到部署目录
install(FILES ${ZLIB_DLL_RELEASE} DESTINATION bin CONFIGURATIONS Release)
install(FILES ${ZLIB_DLL_DEBUG} DESTINATION bin CONFIGURATIONS Debug)

这种方式能准确获取对应配置的动态库文件名（比如Windows下Debug版的zlibd.dll），完全不用手动判断后缀。

3. 批量复制依赖二进制文件（简化版） #

如果依赖较多，不想逐个处理，可以直接从Conan暴露的_BIN_DIR目录复制所有符合条件的文件：

# 适配多配置的写法
install(DIRECTORY ${ZLIB_BIN_DIR_$<UPPER_CASE:$<CONFIG>>}/
        DESTINATION bin
        FILES_MATCHING 
        PATTERN "*.dll"  # Windows
        PATTERN "*.so*" # Linux
        PATTERN "*.dylib" # macOS
        )

4. 配合Conan Deploy生成器的简化方案 #

若不想在CMake中编写过多逻辑，可使用Conan的deploy生成器自动收集所有依赖的二进制文件：

# conanfile.txt 中添加deploy生成器
[generators]
deploy
cmake_find_package

Conan会在构建目录下生成deploy/bin目录，包含所有依赖的动态库，CMake中直接复制该目录：

install(DIRECTORY ${CMAKE_BINARY_DIR}/deploy/bin/
        DESTINATION bin)

注意：该方式会复制所有依赖的所有二进制文件，可能包含冗余，可通过FILES_MATCHING过滤。

避坑要点 #

• 绝对不要硬编码Conan缓存路径（如~/.conan/data/xxx），必须使用Conan生成的CMake变量或目标属性，保证跨机器、跨环境的兼容性。
• 若在CMake中自动调用Conan（通过conan_cmake_install），需确保该命令在find_package前执行，保证路径配置文件已生成。
• 多配置环境（如Visual Studio）下，必须区分Debug/Release的变量和目标属性，避免复制错误版本的动态库。

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