原文作者:Angel G. Olloqui
原文链接:http://angelolloqui.com/blog/31-How-to-fix-a-Duplicated-Symbols-error-on-binary-files
介绍
将第三方库包含在项目中时,可能会在链接过程中遇到“Duplicated Symbols(重复的符号)”错误。 这个令人讨厌的错误是由于您的一个或多个类别之间的名称冲突,通常是由以下两种之一引起的:
- 您不使用前缀作为命名空间,并使用通用名称,如Ses sion,User或similar。 这有一个简单的解决方案,因为所有你需要做的是重命名你的类使用前缀。 例如,User可以重命名为AGUser。使用前缀是一个很好的做法,您应该始终遵循没有像C或Objective-C这样的命名空间的编程语言。
- 一个或多个库包含同一个第三方库。这在静态框架和某些构建的库中是相当普遍的。 通常,库的创建者包括通用实用程序,例如SBJON,Reachability以及编译二进制内的类似内容。然后,您的项目或其他使用它的库尝试再次包含它,导致重复的符号错误。 如果您有权访问源代码,可以将重复的一个从您的目标中轻松解决。不幸的是,当这个问题发生时,很多次来自编译的库或框架,它们不能让我们控制源代码文件,而只是用一个二进制文件替代。解决这个问题可能看起来并不容易,甚至只是有可能,但正如我们将在这篇文章中提的那样,并不难看到症结所在。
特别考虑
整个帖子假定两个重复的库是相同的版本,或至少完全向后兼容。此外,我们还假设两个重复的库都没有被修改,因为任何修改都可能会破坏注释的兼容性。如果库不兼容,那么您将需要分析差异,并查看是否可以使用“混合”库来提供所需的兼容性,或者移动其中一个组件以使用其他不兼容的版本。无论如何,解决方案非常受您的应用程序的约束,有点舍本逐末。
举个栗子
为了提高可读性,我们将修复一个真正的项目。 在这个示例项目中,我们有一个名为Serenity的静态框架,其中包含SBJSON库。将CocoaPods与“unoffical-twitter-sdk”一起使用时,会出现重复的符号,这也与SBJSON有关系。 在这种情况下,重复的符号因此包含在Serenity和Pods.a二进制文件中。
我们可以通过操控Podspecs来解决它,从“unoffical-twitter-sdk”中删除SBJSON,但是我们决定将SBJSON从Serenity中删除,因为它不应该被添加在第一个实例中,反正它包含 在CocoaPods中的一个旧版本的SBJSON。
您应该能够在项目中冲突的库中遵循相同的过程。 只需检查并确定要保留的版本,以及要删除的版本(通常保留较新的版本)。
Slimming down the fat binary
大多数库实际上是胖二进制文件。 这意味着您可以在同一文件中找到多个架构的编译二进制代码。例如,在我们的示例项目中,Serenity框架包含三种架构:i386(模拟器),armv7(iPhone 3GS +兼容)和armv7(iPhone 5)。 注意,在写这篇文章的时候,armv7不能被lipo工具识别为有效的架构(它被显示为“cputype(12)cpusubtype(11)”),所以我们需要做一个小技巧来支持它。希望苹果将尽快更新这些工具来支持它。 您可以通过运行以下方式检查库的体系结构:
$ lipo Serenity -info
Architectures in the fat file: Serenity are: armv7 (cputype (12) cpusubtype (11)) i386
为了继续整个过程,我们需要在自己的文件中提取每个架构。 我们可以通过运行:
$ lipo Serenity -thin armv7 -output Serenity.armv7
$ lipo Serenity -thin i386 -output Serenity.i386
$ xcrun -sdk iphoneos lipo Serenity -thin armv7s -output Serenity.armv7s
注意在最后一种情况下使用xcrun是由于缺乏对armv7的支持。 在这篇文章中解释的其余步骤同样适用于armv7,armv7s和i386。
Removing duplicated symbols
现在我们在瘦文件中有两种不同的架构,我们可以继续删除每个文件上的重复符号。 让我们先来看看静态包中包含的符号:
$ ar -t Serenity.armv7
__.SYMDEF
MainView.o
PushRequest.o
PaymentViewController.o
SBJsonBase.o
SBJsonParser.o
SBJsonWriter.o
NSObject+SBJSON.o
NSString+SBJSON.o
FileManager.o
Barcode.o
qr_draw_png.o
QR_Encode.o
png.o
pngerror.o
pngget.o
pngmem.o
pngpread.o
pngread.o
pngrio.o
pngrtran.o
pngrutil.o
pngset.o
pngtrans.o
pngwio.o
pngwrite.o
pngwtran.o
pngwutil.o
我们选择了armv7版本,但是i386和armv7应该是一样的。
我们怀疑,库中包含五个符号:
SBJsonBase.o
SBJsonParser.o
SBJsonWriter.o
NSObject+SBJSON.o
NSString+SBJSON.o
我们只需要运行:
$ ar -d -sv Serenity.armv7 SBJsonBase.o
d - SBJsonBase.o
运行其他4个符号的命令。 然后,重复一切与其他架构(i386和armv7s在我们的情况)。 如果再次使用ar -t
选项检查二进制文件,那么您应该看到符号不再存在。
Fattening the library
好的,我们差不多完成了 我们有三种架构没有重复的符号。 我们现在需要做的就是将它们重新组合成一个将用于我们项目的胖库。 所以首先让我们移动旧版本并保留一个副本,以防出现问题。
$ mv Serenity Serenity_original
And now lets build the fat library:
$ lipo Serenity.armv7 Serenity.armv7s Serenity.i386 -create -output Serenity
你做到了! 你应该有一个新的二进制文件没有重复的类。 您现在可以删除中间的Serenity.armv7,Serenity.armv7s和Serenity.i386文件,因为它们不再需要。
Finishing
如果您现在再次构建项目,您应该可以链接,而不会在之前呈现的重复符号错误(至少没有这个,也许你有另一个)。
重要的是,您再次测试您的应用程序,因为如果上述任何特殊注意事项不能满足您的应用程序可能会发生故障甚至崩溃。 测试,测试和测试!
最后记住,你只是修改了第三方库,所以不要忘记,任何更新都可能会再次包含重复的符号。 请不要责怪我,如果有什么不起作用,只要求你的第三方开发人员正确地完成工作,并将依赖关系从二进制文件中删除:D。
以上;
分割线---------------------------------------------------------
谢谢!如有出入,敬请见谅!之前使用融云的库有过这个冲突,就依照这个方法顺利解决。嗯,就这样吧,如果还是解决不了,私信我,一起来看看。