iOS 第三方静态库冲突产生的duplicate symbol

第三方静态库冲突产生的duplicate symbol

@(iOS)[Xcode, Mac]

错误描述

• 项目中引用了很多第三方库，有时就会出现一些冲突，比如下面

duplicate symbol _OBJC_IVAR_$_RXMLDocHolder.doc_ in:
    /.../Frameworks/libWintoneCardOCR.a(RXMLElement.o)
    /.../Frameworks/libWintonePlateIDPro.a(RXMLElement.o)
duplicate symbol _OBJC_IVAR_$_RXMLElement.node_ in:
    /.../Frameworks/libWintoneCardOCR.a(RXMLElement.o)
    /.../Frameworks/libWintonePlateIDPro.a(RXMLElement.o)
duplicate symbol _OBJC_IVAR_$_RXMLElement._xmlDoc in:
    /.../Frameworks/libWintoneCardOCR.a(RXMLElement.o)
    /.../Frameworks/libWintonePlateIDPro.a(RXMLElement.o)
duplicate symbol _OBJC_CLASS_$_RXMLDocHolder in:
    /.../Frameworks/libWintoneCardOCR.a(RXMLElement.o)
    /.../Frameworks/libWintonePlateIDPro.a(RXMLElement.o)
duplicate symbol _OBJC_METACLASS_$_RXMLDocHolder in:
    /.../Frameworks/libWintoneCardOCR.a(RXMLElement.o)
    /.../Frameworks/libWintonePlateIDPro.a(RXMLElement.o)
duplicate symbol _OBJC_CLASS_$_RXMLElement in:
    /.../Frameworks/libWintoneCardOCR.a(RXMLElement.o)
    /.../Frameworks/libWintonePlateIDPro.a(RXMLElement.o)
duplicate symbol _OBJC_METACLASS_$_RXMLElement in:
    /.../Frameworks/libWintoneCardOCR.a(RXMLElement.o)
    /.../Frameworks/libWintonePlateIDPro.a(RXMLElement.o)
ld: 7 duplicate symbols for architecture arm64
clang: error: linker command failed with exit code 1 (use -v to see invocation)

问题分析

• 初步判断libWintoneCardOCR.a和libWintonePlateIDPro.a两个静态库在RXMLElement.o输出文件中有命名冲突
• 而且是duplicate symbols for architecture arm64 ，把其中一个的RXMLElement.o移除就行。

解决方式

• mac OS 下使用命令行工具 lipo来的对静态库进行处理。

一、设置 other linker flags

• Bulding Setting里设置的other linker flags添加的有-Objc，而-Objc得作用就是将加载的静态库中的分类一并加载到程序的可执行文件，如果不添加这个参数，很有可能会出现selector not recognized问题，主要是找不到分类定义的方法。
• -Objc添加后就会出现多个静态库定义同样的方法、全局变量等，然后就会出现上面的问题duplicate symbol。

other linker flags解析

• －ObjC：加了这个参数后，链接器就会把静态库中所有的Objective-C类和分类都加载到最后的可执行文件中
• －all_load：会让链接器把所有找到的目标文件都加载到可执行文件中，但是千万不要随便使用这个参数！假如你使用了不止一个静态库文件，然后又使用了这个参数，那么你很有可能会遇到ld: duplicate symbol错误，因为不同的库文件里面可能会有相同的目标文件，所以建议在遇到-ObjC失效的情况下使用-force_load参数。
• -force_load：所做的事情跟-all_load其实是一样的，但是-force_load需要指定要进行全部加载的库文件的路径，这样的话，你就只是完全加载了一个库文件，不影响其余库文件的按需加载

• 这种方式，如果项目中第三方库很多，比较难管理

二、修改静态库

• 1、找到静态库文件 libWintonePlateIDPro.a 源文件，新建一个文件夹专门处理

• 2、查看包信息 lipo -info libWintonePlateIDPro.a

• 3、创建临时文件夹，用于存放armv7平台解压后的.o文件：mkdir armv7

• 4、查看库中所包含的文件列表：ar -t armv7/libWintonePlateIDPro.a

• 5、解压出.o后缀文件：cd armv7 && ar xv libWintonePlateIDPro-armv7.a

• 6、找到冲突的包（RXMLElement.o），删除掉 rm RXMLElement.o

• 7、重新打包成 .a：cd .. && ar rcs libWintonePlateIDPro-armv7.a armv7/*.o，可以使用[4]命令查看是否成功

• 8、将其他几个平台(armv7s, arm64,i386)包逐一做上述[1-7]操作

• 9、重新合并为libWintonePlateIDPro的.a文件：lipo -create libWintonePlateIDPro-armv7.a libWintonePlateIDPro-armv7s.a -output libWintonePlateIDPro-new.a

• 这种方式可以从根本上解决问题

参考1
参考2