使用Swift开发SDK的优点是,生成的SDK对于Obj-C或是Swift调用都不需要自己去建桥接文件,因为Swift的SDK打包时默认已经自动生成供OC调用的.h文件。OC调用时直接import,sdk中的.h文件即可。而Swift调用时,import该SDK名即可。
制作SDK的整个过程也十分简单,网上的博客多的不能再多(大多基于OC)。
使用Swift开发,里面会遇到千奇百怪的坑!所以写这篇博客的目的分享下这些坑的解决经验。
1.工程组合的方式:
开发SDK,不建议直接把SDK当APP开发,不然每次SDK的导出非常麻烦。建议采用SDK工程和Demo工程组合的方式,这样利于导出也利于调试。
首先你新建一个framework的工程A开发SDK,再建立一个普通的APP工程B,然后把工程A拖到工程B中,这样就组成了一个工程。下次在开发的时候直接使用B工程开发即可。
这里需要注意的是,假如你需要在B中使用SDK,就需要把A产出的Product里的XXX.framework供B来引用,这里需要在B的demo工程中的Build Phases里设置2-3个地方去添加,比如
(1)Link Binary With Libraries
(2)embed frameworks
(3)copy bundle resources (假如该framework有图片,xib等资源,这里有个关于bundle的注意点下面等等会提到)
2.第三方的管理:
在开发SDK时,开发者应该有一个共识,那就是千万不能把三方的源码打包进自己的SDK。比如我需要用到MBProgressHUD,我把它封进SDK里,不但程序会很大,别人再次导入也会产生编译冲突。所以最好还是使用CocoaPods,在文档中告诉别人使用的三方库和版本号。
3.桥接文件:
假如我们在Swift的SDK中需要引用到OC文件,是不需要添加桥接文件的。(在普通app工程中是需要的)swift的SDK工程会自动生成一个xxxx.h的头文件,你需要做的有2步:
(1)在.h中import你使用到OC类的头文件。
(2)在SDK的工程设置中的Headers里,把.h放到public中,如下:
假如你之前的工程使用到了桥接文件,你要把它改成SDK,你需要把桥接文件干掉,然后把里面import的东西搬到xxxsdk.h中。
4.资源文件的调用:
假如你在SDK中使用到图片,Xib,Storyboard等资源,在APP中也许我们能直接调用,比如UIImage(Named:"xxx"),但是普通的APP会默认搜索工程目录,这也称为MainBundle。
但是SDK中,资源文件是以工程目录/xxxSDK.Framework/xxx.png的形式存放的,所以按直接名字取的方法,绝对是直接崩溃的。
这个坑我还没有找到完美的解决办法。
(1)最合理的方式,必然是把所有的资源文件,包括XIB、图片等全部加入一个Bundle,但是Bundle的位置也是在SDK中,同样尴尬的无法找到。解决办法是,在该资源的位置前面,加入xxxSDK.Framework/xxx.bundle找到这个Bundle,然后再去找到图片,但是Bundle这东西,太垃圾了,非常难用。
(2)一个比较简单,但不是很规范的方法,定义一个全局变量let SourceRootUrl = "xxxSDK.Framework/",然后在每次调用资源前面,加入这个目录关系,比如图片,UIImage(Named:SourceRootUrl+"xxx"),xib,storyboard同样需要。
关于这点,我觉得Xcode在之后应该会推出更好的解决办法。
5.CPU架构的支持:
这点非常坑,Xcode能debug出或者release出的架构非常单一,要么是真机架构的,要么是模拟器架构的,但实际上我们提供给开发者的SDK可能是真机和模拟器两个平台都需要的。
所以我们可以对两个库进行合并,使用lipo -create a b -output c (具体方式自己百度搜索lipo -create),【这里要注意的是我们合并的是xxxSDK.Framework里的xxxSDK文件,而不是整个framework,合并成c后,我们再放入替换某个a或b】
但是这里有个坑,使用swift开发出的SDK,通过lipo -create合并出的Framework,OC是模拟器和真机都能调用的,但是Swift的工程缺只能调用其中1个,可能是和这种合并不是非常规范。
这一点,官方居然不提供点更直接点的方法?
然后就是,关于armv7s的架构(仅iPhone5),Xcode默认已经不支持,所以假如你其中一个第三方不支持armv7s,你的SDK也就不支持了,人家的APP也不可能支持了。
6.重名问题:
SDK的启动类和SDK名,不要命名成一样的。否则你会后悔的。
7.删除framework后残留问题
有时候也许你明明已经把SDK从工厂中挪走了,但是编译的时候还是不通过,甚至运行的时候出现未找到xxxSDK。
为什么?因为Xcode非常傻*。你把SDK挪走了,但是你之前加过target,link with libraries,bundle等还残留着之前那个目标framework,然后一运行,还是试图去加载之前那个framework,就崩溃了,真是傻啊。
8.莫名崩溃,又莫名好了
我感觉Xcode的隐形BUG已经非常的多了,尤其是结合Storyboard或是Xib后,BUG直接多一个数量级。
所以这也是很多人建议少用界面编辑器去做APP的原因,有时候就是莫名其妙的错。
然而你可能重启下电脑,关闭下Xcode,或许clean up一下,也许根本就没问题。
所以假如出现了一个长达几小时让人自信到不可能有问题的BUG,不妨重启clean up -> 重启Xcode -> 重启电脑下。