如何将第三方静态库封装进动态库

随着动态库的流行,静态库越来越少了(关于动态库和静态库的介绍请点击),但是不排除项目中有些依赖的第三方还是使用的静态库。那么这种情况下就可以考虑,将第三方静态库做一个二次封装。一来和业务代码进行隔离,方便以后第三方库的升级,二来将静态库封装进动态库里便于管理和利用动态库的优势。一般情况下,用动态库封装静态库很简单,就是将静态库直接拖进动态库的工程里,直接编译即可。但是有一种情况下这么做是不行的,需要暴露静态库的头文件,也就是虽然静态库放在动态库里面了,但是静态库的头文件还要提供给上层应用调用。
下面以封装百度地图为例,介绍如何将第三方静态库封装进动态库。
百度地图根据业务不同,划分了很多不同的包,大概包括基础包、定位包、地图包、搜索包、工具包、全景包等。如下图所示:

百度地图包
这些包虽然是以.framework为后缀,但是都是静态库。
首先,新建一个动态库工程,直接将这些包拖入到工程中。
集成百度地图包
但是这时没有办法在BaiduMapKit.h中对外暴露头文件,因为百度地图的头文件都在.framework里面。如果不暴露头文件,也就意味着应用层无法调用。
BaiduMapKit.h文件
遇到这种情况,解决思路有三种。

第一种,用代码将百度地图库封装一层。

也就是自己代码调用百度地图库,然后将自己代码对外暴露,供应用层调用。这是最好的一种思路,不仅能解决问题,还能将第三方库和自己的项目业务隔离去耦合。对于一般的库(比较小的库),非常推荐这种思路。但是对于百度地图来说,不好执行,因为百度地图的API太多太复杂了,如果一点一点去封装,工作量太大了。当然有人说,不一定要将所有的API都重新封装,用到哪些才封装哪些,这样当然是可以的。不过还是挺困难的,百度地图里面定义的类型太多了,哪怕是只用地图这一个功能的API,工作量都挺大。
第一种思路

第二种,将百度地图的.framework包拆开为.a和.h文件。

上面提到,在.framework里面的头文件没办法对外暴露,那么把.framework这层壳去掉呢?

.framework本质上只是一个文件夹,而静态库.framework文件夹里面其实是.a文件和其头文件.h,把.framework文件夹去掉之后,就可以把里面的.h头文件暴露出去了。一般的库这么做是可以的,也比较方便,但对于百度地图来说,是不行的。原因很简单,百度地图各个包之间有依赖关系,即各包之间存在引用关系。去掉.framework文件夹和不去掉,引用方式是不一样的。.framework文件夹引用方式是使用尖括号import <xxx/xxx.h>,去掉之后引用方式就变成了普通文件的引用import "xxx.h"。百度地图各包之间的引用肯定是import <xxx/xxx.h>,如果去掉.framework文件夹,引用方式变了,也就导致文件找不到,编译不成功。
.framework拆包

第三种,为百度地图的.framework包额外添加.h头文件。

上面讨论了,对.framework拆包这种方式不适用于百度地图,所以还得想其他办法。比如,.framework包不动,然后在.framework包外再额外加一份头文件呢?事实证明,这样完全是可以的。
额外增加头文件

最终就是以这种方式解决问题。方法虽然很简单,但是需要想法。所以思路和想法非常重要。最终封装的形式如下图所示,demo请点击

最终方案

后续。。。

最近因为隐私政策的原因,需要再一次升级百度地图。百度地图已经升级到6.5.1了。本来以为轻松替换一下静态库就可以完事,但是还是出幺蛾子了,百度地图的几个静态库替换之后,只要外面使用了百度地图里面的类,就会报类找不到错误,也不知道百度地图修改了什么导致的。如下图所示:


升级后报错

经过一番折腾,还是没有搞定,因此确定之前的方案不行了,得另觅出路了。于是又想到了前面说的第一种方案,这种方案是兜底的,是一定可行的,但是就是比较麻烦。那么有没有既可行又简单一点的方案呢?还真有。这次在第一种方案的基础上进行了改良和优化,形成了第四种方案。

第四种,对百度地图类进行扩展。

说通俗一点,就是自己创建一个类,继承百度地图中需要用到的类,对外暴露自己创建的类,这样就避免了在framework外面直接使用百度的类,就不会报上面的错误了。

例如,需要使用到百度地图的BMKMapManager类,在BaiduMapKit.framework中自己创建一个MyMapManager类继承自BMKMapManager,然后对外暴露MyMapManager头文件,在外面调用的时候使用MyMapManager不用BMKMapManager了。因为MyMapManager类继承自BMKMapManager,所以MyMapManager继承了BMKMapManager所有的功能,而且还可以进行一些扩展和封装,简直再合适不过了。很完美地解决了问题,而且没有增加多少工作量。我觉得和之前几种方案比较,这是最完美的一种方案了。现在的方案示意图如下:


方案四

最后,再附加一个遇到的坑。

BaiduMapAPI_Map.framework中包含一个资源包,mapapi.bundle需要放到主工程中,不然会报错。


mapapi.bundle

对外提供的frmework中带资源包,不解决路径问题,真是很坑很拉胯。报的莫名其妙的错误如下,没有太多Log信息,调试了很久很久才发现是资源包不对,浪费了很多宝贵的时间。

-[MTLDebugRenderCommandEncoder validateCommonDrawErrors:instanceCount:baseInstance:maxVertexID:]:5161: failed assertion `Draw Errors Validation
renderPipelineState must be set.
'
dyld4 config: DYLD_LIBRARY_PATH=/usr/lib/system/introspection DYLD_INSERT_LIBRARIES=/Developer/usr/lib/libBacktraceRecording.dylib:/Developer/usr/lib/libMainThreadChecker.dylib:/Developer/Library/PrivateFrameworks/GPUTools.framework/libglInterpose.dylib:/Developer/Library/PrivateFrameworks/DTDDISupport.framework/libViewDebuggerSupport.dylib
-[MTLDebugRenderCommandEncoder validateCommonDrawErrors:instanceCount:baseInstance:maxVertexID:]:5161: failed assertion `Draw Errors Validation
renderPipelineState must be set.
'
报错
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,080评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,422评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,630评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,554评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,662评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,856评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,014评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,752评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,212评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,541评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,687评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,347评论 4 331
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,973评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,777评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,006评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,406评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,576评论 2 349

推荐阅读更多精彩内容