翻译--How to fix a "Duplicated Symbols" error on binary files

原文作者: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。

content_duplicatedsymbols.png

您应该能够在项目中冲突的库中遵循相同的过程。 只需检查并确定要保留的版本,以及要删除的版本(通常保留较新的版本)。

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。

以上;
分割线---------------------------------------------------------

谢谢!如有出入,敬请见谅!之前使用融云的库有过这个冲突,就依照这个方法顺利解决。嗯,就这样吧,如果还是解决不了,私信我,一起来看看。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容