mac系统动态库加载问题

原创于 2023-12-21 16:36:18 发布 · 1.3k 阅读

CC 4.0 BY-SA版权

文章标签：

文章讲述了在Mac平台的QT项目中遇到dyld:Librarynotloaded问题的原因，即默认不搜索非标准库路径。解决方法是将动态库放入Contents/Frameworks，通过.pro文件配置@executable_path或@loader_path指定运行时库加载路径，推荐使用@executable_path简化路径。

最近在进行公司项目在集成SDK工作时，由于该项目采用QT的跨平台编译，在mac端使用动态库时，运行经常会报dyld: Library not loaded的问题，现总结下：

1、在 Mac 系统中，默认搜索库的路径是 /usr/lib ，并不像 Windows 一样 dll 放在和 exe 同级目录下也会被搜索到。即便你把动态库放到了.app的包里面了，在打开app运行时还是不能加载。因此会产生dyld: Library not loaded的问题。

2、解决该类问题首先要将项目运行时所依赖的动态库放在相应的Runpath下，在mac端一般是在Contents/Frameworks文件夹，如下所示：

3、接下来需要告诉项目动态库的搜索路径，QT项目中是由pro文件来配置项目的编译、库的加载。因此需要再该文件中进行动态库运行依赖路径的指定。此外由于mac端项目的编译依赖于XCode，在XCode中有两种指定路径加载方式：

1）@executable_path 这个变量表示可执行程序所在的目录. 比如 /path/QQ.app/Contents/MacOS/
2）@loader_path 这个变量表示每一个被加载的 binary (包括App, dylib, framework,plugin等) 所在的目录.
在一个程序中, 对于每一个模块, @loader_path 会解析成不用的路径, 而 @executable_path 总是被解析为同一个路径(可执行程序所在目录).

相较于第二种，第一种只需要将放在可执行文件的上一级目录的Frameworks文件夹下面，因此采用第一种方式加载：