iOS组件依赖避免冲突的小技巧分享
问题缘由
本文以YBImageBrowser[1]组件举例。
YBImageBrowser依赖了SDWebImage,在使用CocoaPods集成到项目中时,可能会出现一些依赖冲突的问题,最近社区提了多个Issues并且在Insights->Traffic->Popularcontent中看到了此类问题很高的关注度,所以不得不着手解决。
严格的版本限制
一个开源组件的迭代过程中,保证上层接口的向下兼容就不错了。为了优化性能并且控制内存,YBImageBrowser没有直接用其最上层的接口,而是单独使用了下载模块和缓存模块,SDWebImage的迭代升级很容易导致笔者的组件兼容不了,所以之前一直是类似这样依赖的:
s.dependency'SDWebImage','~>5.0.0'
这样做的好处是限制足够小版本范围,降低SDWebImage接口变动导致组件代码错误的风险。但如果SDWebImage升级到5.1.0,不管相关API是否变动,CocoaPods都视为依赖冲突。
其它组件依赖了不同版本的SDWebImage
当两个组件依赖了同一个组件的不同版本,并且依赖的版本没有交集,比如:
A.dependency'SDWebImage','~>4.0.0' B.dependency'SDWebImage','~>5.0.0'
那么A和B同时集成进项目会出现依赖冲突。
解决方案
使用CocoaPods集成项目非常便捷,对于组件使用者来说,总是想在任何场景下都能轻易集成,并且能在将来享受组件的更新优化,显然前面提到的问题可能会影响集成的便捷性。
更模糊的版本限制
很多时候一个大版本的组件不会改动API,并且对于社区流行的组件我们可以寄一定希望于其做好向下兼容,所以放宽依赖的版本限制能覆盖将来更多的版本(规则参考:podspecdependency[2]):
s.dependency'SDWebImage','>=5.0.0'
为什么不干脆去掉版本限制呢?
因为YBImageBrowser3.x是基于SDWebImage5.0.0开发的,笔者可以明确不兼容5.0.0之前的版本,所以在SDWebImage将来迭代版本出现相关API不兼容之前,这个限制都是“完美”覆盖所有版本的。
避免依赖冲突的暴力方案
当有其它组件依赖了不同版本的SDWebImage,粗暴的解决方案如下:
•直接修改其它组件依赖的SDWebImage版本。
•将YBImageBrowser手动导入项目,并且修改代码去适应当前的SDWebImage版本。
•社区朋友一个Issue中提到的方法:在~/.cocoapods/repos目录下找到YBImageBrowser文件夹,更改对应版本的podspec.json文件里对SDWebImage的依赖版本。
显然,上面的几种方案不太优雅,手动导入项目难以享受组件的更新优化,修改本地repo信息会因为repo列表的更新而复位。
避免依赖冲突的优雅方案
出现依赖冲突是必须要解决的问题,其它组件依赖的版本限制可以视为不变量,解决方案可以从组件的制作方面考虑。
要做到的目标是,既满足部分用户快速集成组件,又能让部分用户解决依赖冲突的前提下保证能享受组件将来的更新优化。
答案就是subspec,以下是YBImageBrowser.podspec部分代码(完整代码[3]):
s.subspec"Core"do|core| core.source_files="YBImageBrowser/**/*.{h,m}" core.dependency'SDWebImage','>=5.0.0' end s.subspec"NOSD"do|core| core.source_files="YBImageBrowser/**/*.{h,m}" core.exclude_files="YBImageBrowser/WebImageMediator/YBIBDefaultWebImageMediator.{h,m}" end
由此,用户可以自由的选择是否需要依赖SDWebImage,在Podfile里的观感大致是这样:
//依赖SDWebImage pod'YBImageBrowser' //不依赖SDWebImage pod'YBImageBrowser/NOSD'
那么在YBImageBrowser代码中应该如何区分是否依赖了SDWebImage并且提供默认实现呢?
第一步是设计一个抽象接口(这个接口不依赖SDWebImage):
@protocolYBIBWebImageMediator//Downloadmethode,cachingmethode,andsoon. @end
第二步是在YBImageBrowser.h中定义一个遵循该接口的属性:
///图片下载缓存相关的中介者(赋值可自定义) @property(nonatomic,strong)idwebImageMediator;
第三步是实现一个默认的中介者(这个类依赖了SDWebImage):
@interfaceYBIBDefaultWebImageMediator:NSObject@end @implementationYBIBDefaultWebImageMediator //通过SDWebImage的API实现 协议方法 @end
第四步是在内部代码中通过条件编译导入并初始化默认中介者:
#if__has_include("YBIBDefaultWebImageMediator.h") #import"YBIBDefaultWebImageMediator.h" #endif ... #if__has_include("YBIBDefaultWebImageMediator.h") _webImageMediator=[YBIBDefaultWebImageMediatornew]; #endif
第五步在YBImageBrowser.podspec中也可以看到,在不依赖SDWebImage的集成方式时排除了两个文件:YBIBDefaultWebImageMediator.{h.m}。
由此便实现了目标:
•用依赖SDWebImage的集成方式快速集成。
•使用不依赖SDWebImage的集成方式避免各种情况下的依赖冲突,但注意这种情况需要自行实现一个遵循
以上便是避免依赖冲突的小技巧,希望读者朋友能提出更好的建议或意见