最近公司项目在使用动态库时,在运行时经常会报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,如下:
如果是使用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为例):
我指定了在我的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可执行文件依赖的动态库的情况
如上依赖的libTang4CEFSDK.dylib就是没有问题的。