iOS经典错误library not found for -lXXX – 简书

来源: iOS经典错误library not found for -lXXX – 简书

开发中经常会和ibrary not found for -xxx打交道,尤其是我们从远程仓库或者github clone下来一个项目,编译很有可能报这个错误。如下图:

报错信息

library not found for -lXXX 属于iOS经典错误之一。下面我们通过复现这个错误的方式来说明这个错误的解决方法。其中l是lib(library)的意思。

首先声明,我的工程中引用了友盟的统计SDK,名称叫做libMobClickLibrary.a。存储在 third_party目录下,如下图(左图为libMobClickLibrary.a在工程目录/虚拟目录的位置,右图为libMobClickLibrary.a在磁盘目录/物理目录的位置):

工程目录

磁盘目录

没有配置Library Search Paths导致报错

(1)删除building setting -> Library Search Paths下的 $(PROJECT_DIR)/YunFu/third_party/UMAnalytics。如下图:
那么,你可能会问,为什么要删除这个路径而不是其他的路径呢?因为我知道这个路径就是libMobClickLibrary.a静态库的目录。

(2)command + B编译项目,然后不出所料,我们会遇到下面这个错误:

(3)点开这个错误,然后就能看到这个经典错误,如下图:
这个错误的意思是找不到名字叫做 MobClickLibrary的库。

至此,我们可知,就因为我们在Library Search Paths下删除了$(PROJECT_DIR)/YunFu/third_party/UMAnalytics 导致报这个library not found for -lMobClickLibrary的错误。所以下次遇到同类问题,我们便可知道某个静态库的路径可能没有配置。

结论一:没有配置静态库的search路径导致出现library not found for lXXX。
注意:设置的路径必须是静态库在磁盘下的路径(物理目录),不能设置为项目的虚拟目录。拿此例来说,libMobClickLibrary.a的在项目中是放在third_party文件夹下的,而其真正的磁盘路径是third_party下的UMAnalytics文件夹。


没有正确配置Library Search Paths导致报错

上面的情况是,我们没有配置某个静态库的路径会导致library not found for lXXX错误。而有时候,我们确实在Library Search Paths下配置了静态库路径,却依然报同样错误。此时我们就要考虑,这个路径配置的到底对不对。如下图(分别是libMobClickLibrary.a正确的路径和错误的路径):
正确路径:

正确路径

错误路径(去掉了最后一级目录”/UMAnalytics”):

错误路径

编译项目依然会报同样的错误library not found for -lMobClickLibrary.a,如下图:

错误信息

归根到底,原因在于,我们虽然跟他指定了libMobClickLibrary.a的目录,但是在所指定的目录下没有搜索到静态库libMobClickLibrary.a。此时又分为两种情况:

  • 情况一:如果我们指定的目录和静态库libMobClickLibrary.a的目录完全不相关,那么需要重新到Library Search Paths下设置(注意:设置的是静态库的磁盘路径)
  • 情况二:如果我们指定的目录和静态库的目录有关系。即,我们指定的目录是静态库所在目录的上级目录,或者是上上级目录。这种情况下,无需指定静态库的精确的路径,只需要把non-recursive选项修改为recursive即可。如下图:

    设置recursive

因为recursive选项代表在我们指定的目录下递归搜索静态库。即,如果在当前目录没有搜索到静态库,那么就去当前目录的子目录下继续搜索。默认情况下是non-recursive(非递归)的。

结论二:虽然Library Search Paths 中配置了静态库的search路径。但是没有正确配置而导致出现library not found for lXXX。


导入第三方framework静态库编译报错xxx.h file not found

上面讲的是当我们项目导入的是.a静态库,但因为没有在 Library Search Paths 中配置.a静态库的search路径,或者是虽然配置了路径但是路径配置错误而导致出现library not found for -xxx错误的解决办法。
但我们知道,在iOS中,静态库有两种形式:.a格式的静态库和.framework格式的静态库。
那么如果我们的项目中引入了.framework格式的静态库要不要配置search路径呢?答案是肯定的,无论我们以什么方式导入.framework静态库(cocoapods的方式或者直接把framework静态库拖拽到项目中的方式),如果没有配置framework的search路径,同样会报错,但报的错误却是和.a格式的静态库有些不同,如果我们项目中引入了framework格式静态库也使用了静态库(所谓使用就是import了framework静态库中的某个头文件),但没有配置search路径,那么就会报 xxx.h file not found 这类错误。如下图:

xxx file not found

因为我的项目中引入了一个叫做PushCenterSDK.framework的静态库。同时也使用了这个静态库中的某个API。如下图所示,分别是静态库在项目中的路径和磁盘路径:

在项目中的路径

在磁盘中的路径

我们依然采用复现问题的方式来验证解决错误的方法,首先,我的项目是可以编译通过的,然后尝试在build setting -> Framework Search Paths 下删除PushCenterSDK.framework的搜索路径(磁盘路径),下图分别是删除前和删除后的截图:

删除前:

删除前

删除后:

删除后

删除路径之后编译项目,发现出现了如下错误XXX.h file not found, 如下图:
很显然,没有找到PushCenterSDK 下的TBSDKPushCenterEngine.h文件。

报错

综上,framework静态库的路径也是必须的,如果项目中的framework静态库的路径配置错误或者没有配置就会报错 xxx.h file not found 类似错误。下次遇到这类错误,便可以从framework search paths 着手思考。

同样,framework静态库的搜索路径也支持递归搜索,我们不必配置一个精确无误的路径,可以指定一个父级目录,然后选择 recursive。

结论:无论我们以什么方式导入.framework静态库(cocoapods的方式或者直接把framework静态库拖拽到项目中的方式),如果没有配置framework的search路径,同样会报错,但报的错误却是和.a格式的静态库有些不同,如果我们项目中引入了framework格式静态库也使用了静态库(所谓使用就是import了framework静态库中的某个头文件),但没有配置search路径,那么就会报 xxx.h file not found 这类错误


文/VV木公子(简书作者)
PS:如非特别说明,所有文章均为原创作品,著作权归作者所有,转载请联系作者获得授权,并注明出处,所有打赏均归本人所有!

作者:VV木公子
链接:http://www.jianshu.com/p/72aec7e38ef0
來源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

分享到: 更多 (0)