随着动态库的流行,静态库越来越少了(关于动态库和静态库的介绍请点击),但是不排除项目中有些依赖的第三方还是使用的静态库。那么这种情况下就可以考虑,将第三方静态库做一个二次封装。一来和业务代码进行隔离,方便以后第三方库的升级,二来将静态库封装进动态库里便于管理和利用动态库的优势。一般情况下,用动态库封装静态库很简单,就是将静态库直接拖进动态库的工程里,直接编译即可。但是有一种情况下这么做是不行的,需要暴露静态库的头文件,也就是虽然静态库放在动态库里面了,但是静态库的头文件还要提供给上层应用调用。
下面以封装百度地图为例,介绍如何将第三方静态库封装进动态库。
百度地图根据业务不同,划分了很多不同的包,大概包括基础包、定位包、地图包、搜索包、工具包、全景包等。如下图所示:
首先,新建一个动态库工程,直接将这些包拖入到工程中。
第一种,用代码将百度地图库封装一层。
也就是自己代码调用百度地图库,然后将自己代码对外暴露,供应用层调用。这是最好的一种思路,不仅能解决问题,还能将第三方库和自己的项目业务隔离去耦合。对于一般的库(比较小的库),非常推荐这种思路。但是对于百度地图来说,不好执行,因为百度地图的API太多太复杂了,如果一点一点去封装,工作量太大了。当然有人说,不一定要将所有的API都重新封装,用到哪些才封装哪些,这样当然是可以的。不过还是挺困难的,百度地图里面定义的类型太多了,哪怕是只用地图这一个功能的API,工作量都挺大。第二种,将百度地图的.framework包拆开为.a和.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需要放到主工程中,不然会报错。
对外提供的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.
'