静态库联调中的若干问题

毫无意义的封面图

一.概述

日常开发中,静态库的开发总是要花费开发者很大的精力。工作中我们一般都是在项目中进行代码编写,在需要的时候把代码提出来另行打包,若有需求修改或者调试时,总需要把代码或者库拿回原程序中进行测试修改。
由于工作需要我要经常修改静态库代码中的内容,恰好最近在静态库联调的时候出现了一些问题,记录下来以后避免踩到这些坑。

二、操作步骤

1.创建工程

用Xcode创建一个project,在project-TARGETS中创建一个.a静态库文件:
在project中创建静态库文件
创建好的静态库文件会出现在这里
静态库创建完成

2.在主项目中进行相关配置

主项目配置

3.在静态库文件中配置需要暴露出的头文件

添加暴露的头文件

以上步骤操作是不是都很顺利,让人颇有一种岁月静好的既视感,然而问题来了。在我描述问题之前,先说明一下我project的配置。
在我的项目中除了自己需要打包发布的静态库文件以外,还需要引入很多第三方的SDK:支付宝微信银联银联ApplePayQQ钱包百度钱包用于业务调试。

问题一:

在我需要打包的静态库文件中,需要用到反射NSClassFromString来创建上文提到的SDK中的类以及类对象,然而我尝试了多次未能创建成功。
关于这个问题,在stackoverflow搜索到了相关内容

http://stackoverflow.com/questions/2227085/nsclassfromstring-returns-nil

上面提供了一个解决方法:当你需要实例化静态库中的类以及对象时,需要在Build settings-Linking-Other Linking Flags添加-ObjC

添加配置

:设置-ObjC参数时请一定确认是在主项目上添加的,不要添加到自己创建的静态库项目中去了。

既然已经有解决办法了那就按照方法的指导去做吧,但问题并不是这么容易就能解决的。

问题二:

按照上述的解决办法设置完成,command+B一编译结果一片飘红:
错误信息
结果一看错误信息,一个常见错误在项目中引入了同名的文件,但我之前的操作并没有引入新的文件进我的项目中,仅仅是添加了一个-ObjC参数的配置。

于是我详细查了一下这个参数的意义

This flag causes the linker to load every object file in the library that defines an Objective-C class or category. While this option will typically result in a larger executable (due to additional object code loaded into the application), it will allow the successful creation of effective Objective-C static libraries that contain categories on existing classes.
https://developer.apple.com/library/mac/qa/qa1490/_index.html

大概意思是设置了这个参数会让链接器加载所有Objective-C类和类别,同时也可以加载包含类别的Objective-C的静态库。

这篇文档的最后一句话给了我启示,在没设置这个参数之前是不会链接静态库文件进行编译的,设置完这个参数之后出现了引入同名文件的错误,只有可能是链接上了一个静态库文件而里面的内容跟我project的代码文件重复了,顺着这个思路我联想到了在2.在主项目中进行相关配置进行的第4步:
链接刚创建的静态库文件
可能是添加了-ObjC,链接上了这个静态库文件跟我项目中的代码文件冲突了。定位了问题发生点之后,剩下的就是行动了。果然,删除了这个位置的静态库文件就没有再报错了,项目就可以正常运行了。

总结

踩过这次的坑,做一点总结吧。若你的project不需要引入第三方静态库的时候,可以在主项目中Build Phases - Link Binary With Libraries链接上你自己的静态库文件;若你的project中需要引入第三方静态库,需要在主项目中的Build settings-Linking-Other Linking Flags添加-ObjC参数,就别在Build Phases - Link Binary With Libraries链接上你自己的静态库文件了。

平时开发的时候一般也不会特别的去关注设置某个参数的意义,只知道需要设置这个参数。而这次踩了坑才回头研究了一下某些参数的意义,果然还是要多掉坑成长才快呐~~~

参考文档

http://stackoverflow.com/questions/2227085/nsclassfromstring-returns-nil
http://stackoverflow.com/questions/24298144/duplicate-symbols-for-architecture-x86-64
https://developer.apple.com/library/mac/qa/qa1490/_index.html
http://blog.csdn.net/yanglei3kyou/article/details/52020967


tags: iOS