交叉编译依赖处理及CMake实现同系统二进制分发依赖适配问询

动态库/静态库选型优缺点 #

• 静态库
  • 优点：所有依赖编译时打包进产物，无运行时依赖路径、版本冲突问题，用户可直接调用，无需额外部署依赖
  • 缺点：二进制体积偏大，多程序复用相同依赖时会重复占用内存；依赖有安全漏洞时需你侧重新编译分发，用户无法自行替换依赖版本
• 动态库
  • 优点：二进制体积小，相同依赖可被多程序共享；用户可自行升级依赖修复漏洞，无需你侧重新发版
  • 缺点：需要额外处理运行时依赖路径、版本兼容问题，用户本地依赖版本不符合要求时会出现加载失败

基于CMake实现需求的高层级流程 #

1. 解决动态链接路径不一致问题 #

针对同操作系统的动态库分发，通过配置RPATH实现依赖路径自适应：

• Linux环境：在CMakeLists中添加如下配置，关闭默认的编译时绝对路径RPATH，改为嵌入基于二进制文件位置的相对路径：

set(CMAKE_INSTALL_RPATH "$ORIGIN/../lib")
set(CMAKE_BUILD_WITH_INSTALL_RPATH ON)
set(CMAKE_INSTALL_RPATH_USE_LINK_PATH OFF)

• macOS环境：将CMAKE_INSTALL_RPATH设置为@executable_path/../lib即可，其余配置同上。

配置完成后，用户除了可以把依赖放在你指定的相对路径下，还可以通过LD_LIBRARY_PATH（Linux）/DYLD_LIBRARY_PATH（macOS）环境变量自定义依赖查找路径，无需重新编译你的二进制文件。

2. 生成可被find_package识别的预编译包 #

无需分发源代码，只需在CMake中配置导出规则，即可让用户通过find_package适配任意安装路径：

• 安装你的库目标、头文件时，同步使用install(EXPORT)命令导出目标配置，CMake会自动生成<项目名>Config.cmake、<项目名>Targets.cmake等配置文件，这些文件仅记录链接规则、头文件路径，不包含源代码。
• 将头文件、预编译好的库文件、自动生成的CMake配置文件统一打包为压缩包分发。用户拿到后只需在自己的项目CMake配置中把CMAKE_PREFIX_PATH设置为你的包解压路径，即可直接用find_package()找到你的库，适配任意安装位置。

3. 处理依赖版本差异问题 #

• 若选择动态库分发：编译时通过-Wl,--version-script（Linux）控制符号导出，仅公开你需要暴露的接口，避免第三方依赖的符号冲突；同时在文档中明确标注依赖的最低版本要求。
• 若不想让用户处理第三方依赖：将所有第三方依赖静态编译进你的库中，用户仅需链接你提供的单个库文件即可，无需额外安装其他依赖。

新手入门资源指引 #

• CMake官方文档中install、EXPORT、RPATH相关章节，是最权威的入门资料，可直接搜索对应关键词查看。
• CMake实操类书籍中关于预编译库分发、项目安装配置的章节，适合系统掌握相关规则。
• 技术社区中搜索"CMake 预编译包分发"、"CMake RPATH配置"相关的实操教程，有大量可直接复用的配置示例。

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