iOS 平台 Cocos2d-x 项目 接入第三方SDK 的坑(就是静态库接入的问题)

解决方法是:

-force_load path/to/your/libWeiboSDK.a 而不是 他提供的-ObjC、-all_load,下面是一些详细说明

这里特别给出示范路径,比如你在项目中导入了XXX.a放在一个叫aaa的group文件下,那么路径就是aaa/xxx.a,或者你可以使用全路径,点击对应的xxx.a静态库,会在Xcode的右侧出现该文件的路径,把它复制过来就可以了


遇到的问题

根据新浪微博 SDK 附带的文档接入项目后,在模拟器运行项目,在调用注册方法时发生崩溃。注册方法代码:

1

[WeiboSDK registerApp: @"xxxxxxxx"];

崩溃信息打印如下:

1

[__NSDictionaryM weibosdk_WBSDKJSONString] : unrecognized selector sent to instance 0x170255780

解决问题遇到的阻碍

新浪微博 SDK 附带的文档中有这么一个说明:

在工程中引入静态库之后,需要在编译时添加   –ObjC   编译选项,避免静态库中类 加载   不全造成程序崩溃。方法:程序   Target->Buid   Settings->Linking   下   Other   Linker  Flags   项添加-ObjC

在网上看到遇到同样崩溃错误的人有提到在编译时添加 -all_load 编译选项时也可以解决问题。方法也是在   Target->Buid   Settings->Linking   下   Other   Linker  Flags   项添加-all_load。

无独有偶,我在打开新浪微博 SDK 附带的 Demo 项目时发现这个项目的编译选项也是-all_load而不是它自己文档所提示的-ObjC。而且在同样的开发环境下,我的 cocos2d-x 项目会崩溃,但是新浪微博 SDK 附带的 Demo 可以正常工作,想必上述两个解决方案应该是正解

但是在给自己的 cocos2d-x 项目添加了编译选项后,再次编译运行就发生了错误,错误信息如下:

1

2

3

4

5

6

7

8

Undefined symbols for architecture i386:  "_GCControllerDidConnectNotification", referenced from:  -[GCControllerConnectionEventHandler observerConnection:disconnection:] in libcocos2dx iOS.a(CCController-iOS.o)  "_GCControllerDidDisconnectNotification", referenced from:  -[GCControllerConnectionEventHandler observerConnection:disconnection:] in libcocos2dx iOS.a(CCController-iOS.o)  "_OBJC_CLASS_$_GCController", referenced from:  objc-class-ref in libcocos2dx iOS.a(CCController-iOS.o)  (maybe you meant: _OBJC_CLASS_$_GCControllerConnectionEventHandler)

无论是设置成-ObjC还是-all_load编译都会失败,都会报上述找不到符号的链接错误。

正确的解决办法

这里先给出正确的解决办法再谈谈为什么要这么做。正确的做法还是设置 Other Linker Flags 这个编译选项,只不过即不用用-ObjC也不能用-all_load,而是要用-force_load path/to/your/libWeiboSDK.a,后面跟的是新浪微博 SDK 静态链接库的确切位置。

这一切是为什么?

从编译链接说起

这里不打算过多的介绍编译链接相关的只是,但是强烈推荐一本书《程序员的自我修养》,光看正标题你可能会担心这是本没什么“正经”内容的书,至少我当初第一次看到这书名的时候就是这么认为的,但是我错了,这本书的副标题是链接、装载与库。相信我,看过这本书 N 遍之后你自会对程序从源代码编译链接到生成二进制程序的原理和过程有一个非常透彻的理解,并且更重要的是看过这本书 N 遍之后你会上升几个层次。

言归正传,一个工程的源代码最终变成二进制的可执行程序、动态链接库或静态链接库要经历这么几个过程:

1

源代码 ==[编译器]==》 汇编码 ==[汇编器]==》 对象文件 ==[链接器]==》 可执行程序、动态链接库或静态链接库

再说说符号是什么?

通俗的讲,我们在源码中写的全局变量名、函数名或类名在生成的*.o对象文件中都叫做符号,存在一个叫做符号表的地方。

举个例子:我们在a.c文件中写了一个函数叫foo(),然后在main.c文件中调用了foo()函数,在将源码编译生成的对象文件中a.o对象文件中的符号表里保存着foo()函数符号,并通过该符号可以定位到a.o文件中关于foo()方法的具体实现代码。

链接器在链接生成最终的二进制程序的时候会发现main.o对象文件中引用了符号foo(),而foo()符号并没有在main.o文件中定义,所以不会存在与main.o对象文件的符号表中,于是链接器就开始检查其他对象文件,当检查到a.o文件中定义了符号foo(),于是就将a.o对象文件链接进来。这样就确保了在main.c中能够正常调用a.c中实现的foo()方法了。

libWeiboSDK.a 静态链接库里有什么?

Unix 的静态链接库没什么神秘的,它就是个压缩包,和平时比较常见的 zip 或 rar 之类的压缩包一样,只不过人家是用一个叫 ar 的压缩工具压缩的而已。所以我们给它解压缩一下,看看它里面都有什么。既然是用 ar 压缩的,解压自然也要用 ar 这个工具。在命令行执行:

1

ar -x lieWeiboSDK.a

结果报错了:

1

2

ar: libWeiboSDK.a is a fat file (use libtool(1) or lipo(1) and ar(1) on it) ar: libWeiboSDK.a: Inappropriate file type or format

这里先解释一下它为什么这么肥(fat)。在做 iOS 开发时我们都知道可以用模拟器和真机来测试我们的项目,但是这两个平台的架构是不一样的,模拟器是 i386 x86_64 架构的,而我们的设备是 armv7 arm64 架构的。当在制作静态链接库的时候也要针对不同的架构制作出针对真机和模拟器的两个静态链接库,而当我们想在自己的项目中使用静态链接库的时候,如果在模拟器上运行我们要用针对模拟器的静态库版本,用真机设备测试的时候还要切换到针对真机的静态链接库,这样一来非常的麻烦。

前面说过了静态链接库就是个压缩包,那么我们是否能将这两个静态链接库压缩成一个静态链接库这样就可以同时支持模拟器和真机设备两种架构了呢?答案是肯定的。比如我们手头有一个静态链接库的两个架构版本:libXXX.i386_x86_64.a和libXXX.armv7_arm64.a,那么我们可以通过如下命令来生成一个统一的静态链接库:

1

lipo -create libXXX.i386_x86_64.a libXXX.armv7_arm64.a -output libXXX.a

这样我们就得到了一个统一版本的静态库libXXX.a,它的好处是同时支持模拟器架构和真机设备架构,缺点是它的体积变大了,也就是说它很肥(fat)。

而libWeiboSDK.a就是这么一个合体后的静态库,我们照样可以通过命令来验证这一点:

1

lipo -info libWeiboSDK.a

这个命令会输出:

1

Architectures in the fat file: libWeiboSDK.a are: armv7 arm64 i386 x86_64

既然是个胖子,那我们就要先给它瘦身才能解压。我们随便从里面抽出一个架构的静态链接库来,瘦身命令是:

1

lipo -thin i386 libWeiboSDK.a -output libWeiboSDK.i386.a

这样我们就把针对 i386 平台的新浪微博 SDK 静态链接库给抽离出来了,我们管它叫libWeiboSDK.i386.a,现在我们再用ar命令解压它看看里面有什么

1

ar -x libWeibo.i386.a

解压完成后你会看到好多好多以.o结尾的对象文件,回忆回忆刚刚我们讲到的编译链接过程,这些对象文件就是给链接器最终生成静态链接库时用到的文件,由于太多了,我只列出我们要讲到的几个:

1

2

3

4

5

6

7

8

9

-rw-r--r-- 1 leenjewel staff 13K Jan 8 15:47 NSData+WBSDKBase64.o -rw-r--r-- 1 leenjewel staff 42K Jan 8 15:47 UIImage+WBSDKResize.o -rw-r--r-- 1 leenjewel staff 12K Jan 8 15:47 UIImage+WBSDKStretch.o -rw-r--r-- 1 leenjewel staff 74K Jan 8 15:47 UIView+WBSDKSizes.o -rw-r--r-- 1 leenjewel staff 58K Jan 8 15:47 WBAidManager.o -rw-r--r-- 1 leenjewel staff 15K Jan 8 15:47 WBAuthorizeRequest.o -rw-r--r-- 1 leenjewel staff 16K Jan 8 15:47 WBAuthorizeResponse.o -rw-r--r-- 1 leenjewel staff 19K Jan 8 15:47 WBBaseMediaObject.o -rw-r--r-- 1 leenjewel staff 265K Jan 8 15:47 WBSDKJSONKit.o

为什么会在运行中崩溃?

当我们把新浪微博 SDK 的静态链接库引入我们自己的项目,并 Build 我们自己的项目到模拟器或真机设备上运行的过程其实也是一个编译链接的过程,最终从项目 Build 生成可以在模拟器或真机设备运行的 App,而这个过程中对新浪微博 SDK 的静态链接库的处理方式和我们刚刚拆开libWeiboSDK.a的过程差不多:

将 libWeibSDK.a 根据当前所构建的平台架构(模拟器还是真机设备)进行瘦身将瘦身的静态库解压拆包将用到的对象文件链接进入项目

而我们遇到的崩溃问题恰恰是出在了将用到的对象文件链接进入项目这一步。

苹果的开发者网站针对这个问题有一篇说明文章,我们来引用一下里面的内容:

The dynamic nature of Objective-C complicates things slightly. Because the code that implements a method is not determined until the method is actually called,

这句话解释起来就是说 Objective-C 是有运行时(runtime)的,一个方法要执行什么代码是在运行时决定的,而不是在链接时决定的。想要再深入了解 Objective-C 运行时知识的,可以看看这里

Objective-C does not define linker symbols for methods. Linker symbols are only defined for classes.

因为在 Objective-C 中,一个方法的执行是要到运行时才决定的,所以在链接时,链接器只链接类的符号,并不会链接方法的符号。

For example, if main.m includes the code [[FooClass alloc] initWithBar:nil]; then main.o will contain an undefined symbol for FooClass, but no linker symbols for the -initWithBar: method will be in main.o

最后还举了一个例子:当你在main.m文件中初始化一个类FooClass的对象,然后调用了这个类FooClass的一个对象方法initWithBar,在链接器分析由main.m编译生成的main.o对象文件时,发现这个对象文件没有定义符号FooClass于是就会去其他.o对象文件中去寻找FooClass符号的定义,而至于方法符号initWithBar的定义在哪里链接器是不关心的,因为initWithBar的执行是由运行时负责的,链接器不管。

好了,现在问题来了,我们再重复一下这句话:

1

Objective-C 中方法的执行实在运行时决定的,所以链接器只链接类的符号,不链接方法的符号

我们再回过头看看崩溃的报错信息:

1

[__NSDictionaryM weibosdk_WBSDKJSONString] : unrecognized selector sent to instance 0x170255780

这说明崩溃的原因是在运行时调用__NSDictionaryM类对象的weibosdk_WBSDKJSONString方法时没有找到该方法的定义。这里不难看出__NSDictionaryM是Foundation Framework中的类,而方法weibosdk_WBSDKJSONString是新浪微博 SDK 自己定义的方法,新浪在这里使用了分类技术扩展了__NSDictionaryM类的行为。我们来验证这一点:

我们已经解压出libWeiboSDK.a中的全部.o对象文件,我们用nm命令导出全部对象文件中的符号:

1

nm *.o >> libWeiboSDK.symbols.txt

然后我们用个文本编辑器打开libWeiboSDK.symbols.txt查找weibosdk_WBSDKJSONString,我们可以查到如下结果:

1

2

3

4

WBSDKJSONKit.o: 00007ba0 t -[NSArray(WBSDKJSONKitSerializing) weibosdk_WBSDKJSONString] 00007de8 t -[NSDictionary(WBSDKJSONKitSerializing) weibosdk_WBSDKJSONString] 000079cd t -[NSString(WBSDKJSONKitSerializing) weibosdk_WBSDKJSONString]

这就可以说明新浪微博 SDK 确实使用了分类技术扩展了NSArray、NSDictionary和NSString三个 Foundation Framework 下面的类的行为。好,现在可以真相大白了:

在链接时,链接器发现WBSDKJSONKit.o对象文件中缺少类符号NSArray、NSDictionary和NSString。链接器从Foundation Framework中找到了类的符号定义,从而将Foundation Framework中相关的对象文件链接进来由于链接器不链接方法符号,所以weibosdk_WBSDKJSONString这样的方法符号完全被忽略了。由于类符号的定义在Foundation Farmework中定义,所以WBSDKJSONKit.o对象文件中没有符号被引用,链接器就没有把这个对象文件链接进来。运行时运行到weibosdk_WBSDKJSONString方法时,由于Foundation Framework中是不存在这个方法的定义的,而存在这个方法定义的WBSDKJSONKit.o对象文件又没有被链接器链接进来,所以崩溃了。

为什么增加编译选项可以解决问题?

我们继续引用苹果的开发者网站针对这个问题的说明文章中的内容:

Passing the -ObjC option to the linker causes it to load all members of static libraries that implement any Objective-C class or category. This will pickup any category method implementations. But it can make the resulting executable larger, and may pickup unnecessary objects. For this reason it is not on by default.

加了-ObjC选项后,不管是否被引用到,链接器会把 Objective-C 的类和分类的所有对象文件全部链接,全部链接后方法符号全部被链接进来,崩溃的问题自然被解决了。

而-all_load选项更彻底,这个选项会让链接器把全部的对象文件都链接进来,当然,代价就是构建的 APP 体积会变大。

为什么 cocos2d-x 加了编译选项会无法编译通过?

其实准确的说法是编译可以成功进行,链接器执行报错。我们再回顾一下加了-ObjC或-all_load链接选项后链接器的报错信息:

1

2

3

4

5

6

7

8

Undefined symbols for architecture i386:  "_GCControllerDidConnectNotification", referenced from:  -[GCControllerConnectionEventHandler observerConnection:disconnection:] in libcocos2dx iOS.a(CCController-iOS.o)  "_GCControllerDidDisconnectNotification", referenced from:  -[GCControllerConnectionEventHandler observerConnection:disconnection:] in libcocos2dx iOS.a(CCController-iOS.o)  "_OBJC_CLASS_$_GCController", referenced from:  objc-class-ref in libcocos2dx iOS.a(CCController-iOS.o)  (maybe you meant: _OBJC_CLASS_$_GCControllerConnectionEventHandler)

根据报错信息我们能够了解到报错是一个名叫CCController-iOS.o对象文件导致的,而这个文件对应的源代码是CCController-iOS.mm,通过阅读源码我们发现,这个文件中定义了一个 Objective-C 的类GCControllerConnectionEventHandler,这个类中的方法引用了GCControllerDidConnectNotification和GCControllerDidDisconnectNotification两个类,而这两个类实在GameController Framework中定义的。

而 cocos2d-x 生成的项目默认并没有为我们引入GameController Framework,所以在链接时由于链接器找不到对应类的符号定义,所以才会报错。如果你到 Xcode->Target->Buid Phases-> 下   Link Binary With Libraries   项添加GameController Framework就可以解决问题了,但是这种解决方式很不干净

正确的姿势

-force_load path/to/your/libWeiboSDK.a链接选项其实是干了和-ObjC、-all_load一样的事情,只不过它更有针对性,它只让链接器把你指定的静态链接库中的全部对象文件链接进来,这样更清爽一些。

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

推荐阅读更多精彩内容

  • 静态库与动态库的区别 首先来看什么是库,库(Library)说白了就是一段编译好的二进制代码,加上头文件就可以供别...
    吃瓜群众呀阅读 11,602评论 3 42
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 11,612评论 4 59
  • Swift版本点击这里欢迎加入QQ群交流: 594119878最新更新日期:18-09-17 About A cu...
    ylgwhyh阅读 24,858评论 7 249
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,099评论 18 139
  • 时间过的飞快,不知不觉你已经上初中了,我记忆中那个抹着眼泪不愿意去幼儿园的小女孩,已经变成了一个活泼、开朗的...
    月月2005阅读 220评论 0 1