MAC动态库加载问题

时间:2024-04-04 15:31:45

最近公司项目在使用动态库时,在运行时经常会报dyld: Library not loaded的问题,现总结下:

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

 

2,掌握下mac xcode里面的几个路径含义:

@executable_path 这个变量表示可执行程序所在的目录. 比如 /path/QQ.app/Contents/MacOS/

@loader_path 这个变量表示每一个被加载的 binary (包括App, dylib, framework,plugin等) 所在的目录.

在一个程序中, 对于每一个模块, @loader_path 会解析成不用的路径, 而 @executable_path 总是被解析为同一个路径(可执行程序所在目录). 比如一个会被多个程序调用的 plugin, 位于 /path/Flash Player.plugin/Contents/MacOS/Flash Player, 依赖 /path/Flash Player.plugin/Contents/Frameworks/XPSSO.dylib. 那么 XPSSO.dylib 的 INSTALL_PATH 可以设置为 @loader_path/../Frameworks, 这样设置的话, 不论 Flash Player.plugin 目录放到什么位置, XPSSO.dylib 都能正确的被加载.

@rpath 和前面两个不同, 它只是一个保存着一个或多个路径的变量. 比如 XPSSO.dylib 被两个 .app 使用, 且被包含的路径不同。比如:

softA.app/Contents/MacOS/dylib/XPSSO.dylib

softB.app/Contents/MacOS/Frameworks/XPSSO.dylib

将 XPSSO.dylib 的 INSTALL_PATH 设置成 @loader_path/../dylib 或 @loader_path/../Frameworks 都只能满足其中一个 .app 的需求. 要解决这个问题, 就可以用 @rpath. 将 XPSSO.dylib 的 INSTALL_PATH 设置成 @rpath, 然后在编译 softA.app, softB.app 时分别指定 @rpath 为 @loader_path/../dylib, @loader_path/../Frameworks, 问题得到了解决. @rpath 的另一个优点是可以设置多个路径. 如果 softA.app 还需要使用另一个 .plugin (假设它的 INSTALL_PATH 也设置成了 @rpath), 位于 @loader_path/../plugin, 把这个路径加到 @rpath 即可.

 

3,自我总结:所以对于制作动态库的人来说需要在生成动态库的xcode 配置里面指定下Dynamic Library Install Name,如下:

MAC动态库加载问题

如果是使用cmake的话

set_target_properties(${proj_name}  PROPERTIES FOLDER "CEFWrapper" BUILD_WITH_INSTALL_RPATH 1 INSTALL_NAME_DIR @rpath)
这个@rpath相当于是一个占位符,相当于告诉别人想要使用我这个动态库,你在使用时需要自己填入@rpath的具体路径,这样就会很灵活,使用方可以自己把别人的动态库放到自己app包里面的任何位置,然后自己指定下这个@rpath具体路径就好啦。

使用方使用动态库的步骤:

1,导入头文件,调用代码这些必须的

2,需要把动态库copy到app包里面去

3,需要指定下@rpath的具体路径是什么,如果是xcode配置(本质是使用mac上的install_name_tool [-change old new] 命令)如下(以libcef.dylib为例):

MAC动态库加载问题

我指定了在我的app可执行文件上一级目录的Frameworks下面,并且使用动态库本身确实就是放在Frameworks下面的

如果是使用camke命令的话:

add_custom_command(TARGET ${CEF_TARGET} POST_BUILD
COMMAND install_name_tool -change 
"@rpath/libcef.dylib" 
"${CEF_APP}/Contents/Frameworks/libcef.dylib" 
"${CEF_APP}/Contents/MacOS/${CEF_TARGET}")

-change后的3个参数:

第一个参数是指要替换的动态库路径

第二个参数指想要替换动态库的路径

第三个参数是指可执行文件的路径

 

4,发现加载不了动态库后的解决方案:

(1)先使用otool  -L 命令查看app可执行文件依赖的动态库的情况

MAC动态库加载问题

如上依赖的libTang4CEFSDK.dylib就是没有问题的。