C / C++ / 系统课时

动态库依赖发布时怎么处理

动态库依赖发布时怎么处理

程序在开发机上能运行,复制到目标机器后却提示找不到 .so、.dylib 或 .dll,通常不是编译失败,而是运行时动态加载器无法解析依赖。本节用一个自带共享库的小项目演示如何检查依赖、安排安装目录并验证发布结果。

学习目标

  • 区分构建期链接成功与运行期动态库可发现
  • 检查可执行文件实际依赖的共享库
  • 用安装目录和运行时搜索路径让自有动态库随程序可靠发布

先理解运行时在找什么

链接器在构建阶段只证明“当时能找到库”,目标程序启动时则由操作系统的动态加载器重新定位共享库。只把可执行文件复制走,而没有同时处理它依赖的自有库和搜索路径,程序就可能在目标环境启动失败。

可执行文件、动态加载器与共享库搜索关系

因此发布检查要回答两个问题:程序依赖了哪些动态库,以及这些库在目标机器上是否能通过系统规则被找到。Linux 常用 ldd 或 readelf,macOS 常用 otool -L,Visual Studio 开发者命令行可用 dumpbin /dependents。

把自有共享库安装到固定位置

下面的最小项目包含一个共享库 calc 和一个可执行文件 myapp。Linux 和 macOS 将共享库安装到 lib,Windows 的 DLL 会作为运行时文件进入 bin。

cmake
cmake_minimum_required(VERSION 3.20)
project(runtime_deps LANGUAGES C)

add_library(calc SHARED calc.c)
add_executable(myapp main.c)
target_link_libraries(myapp PRIVATE calc)

if(APPLE)
    set_target_properties(myapp PROPERTIES
        INSTALL_RPATH "@loader_path/../lib"
    )
elseif(UNIX)
    set_target_properties(myapp PROPERTIES
        INSTALL_RPATH "$ORIGIN/../lib"
    )
endif()

install(TARGETS myapp calc
    RUNTIME DESTINATION bin
    LIBRARY DESTINATION lib
    ARCHIVE DESTINATION lib
)

calc.c 提供一个简单函数,main.c 调用它。这里不依赖额外第三方库,便于把问题限定在“自己的共享库是否随发布物被正确找到”。

c
int add(int a, int b)
{
    return a + b;
}
c
#include <stdio.h>

int add(int a, int b);

int main(void)
{
    printf("%d\n", add(2, 3));
    return 0;
}

安装后再验证,而不是只跑构建目录

发布前要验证安装树,因为构建目录往往自带临时搜索路径,程序在其中能运行,并不能证明拷贝后的目录仍然正确。以下命令以 Linux 或 macOS 为例,把文件安装到项目内的 dist 目录后再启动。

bash
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
cmake --install build --prefix dist
./dist/bin/myapp

安装日志中的绝对路径会随环境不同而变化;最终程序应能在 dist/bin 中找到随包发布的 calc 共享库并正常运行。

预期输出

text
5

在 Linux 上还可以直接检查已安装程序解析到的 libcalc.so。

bash
ldd dist/bin/myapp | grep libcalc

预期输出

text
libcalc.so => <PATH>/libcalc.so (<ADDR>)

<PATH> 的实际值应指向当前发布目录中的 dist/lib,<ADDR> 是运行时加载地址,每次执行可能不同。如果这里显示 not found,说明库虽然被安装了,但运行时搜索路径没有覆盖它所在的位置。

不要把所有系统库一起复制

自有共享库通常应该跟随应用发布;第三方库是否打包,则要结合目标系统、许可证和 ABI 兼容策略决定。Linux 上的 glibc 等基础系统组件通常不适合简单复制进应用目录,Windows 的运行库也应按对应工具链的官方再分发方式处理,而不是从开发机随手拷贝 DLL。

动态库发布的关键不是复制得越多越好,而是明确哪些依赖由应用负责、哪些由目标系统负责,并让程序在最终目录结构下稳定解析到前者。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

动态库依赖发布时怎么处理

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通