使用Swift打造SDK和DemoAPP时所遇到的（Xcode7.3）

Posted 2020-06-30 RETHINK

使用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 -> 重启电脑下。