XCode打包SDK

Posted 2023-03-28

参考技术A 原文链接:   http://www.jianshu.com/p/a8366426fe51

一、打包Framework

1、新建ios->Framework & Library->Cocoa Touch Framework

2、选择next进入下一步

3、在PROJECT->Deployment Target->iOS Deployment Target选择你需要支持的最低系统。

同样的操作在TARGETS中，Deployment Info->Deployment Target

4、由于我的framework需要支持iOS7，所以在第2、3步中进行了相应的设置。Build时会发现有️ld: warning: embedded dylibs/frameworks only run on iOS 8 or later警告，这是因为工程默认编译设置的是Dynamic Framework。这种编译只有在iOS8以后才能使用。

5、针对第4步中所出现的问题，根据需求我的工程不需要使用动态framework，以使用其动态更新的功能。动态库可以分开发布，在运行时查找并存入内存，但苹果只允许他自己用，到iOS8以后才开放给开发者。因此，我需要将Dynamic Framework更换为Static Library静态模式。设置路径为Build Settings->Linking->Mach-O Type->Static Library

6、这里要注意，在编译时，不要将图片文件放在工程里面，否则编译后framework中会出现大量的零散图片文件在里面。这时需要将图片等资源放在.bundle文件中。图片的打包在第二步介绍。

7、这样打包的framework依然有问题，如果你用了Category，别人在用你的framework时会发生崩溃。这时别人在引用时需要在工程中other linker flags中添加-objC如果依然有问题，再添加-all_load。

8、终于编译成功，但发现很多关于符号表的警告，这时需要将Generate Debug Symbols设置为NO即可关闭符号表警告。

9、但是我需要支持bitcode，以上设置后并不能使framework支持bitcode,因此还需要进行额外的设置一个命令让其支持bit code。在TAGETS的Build setting中搜索Other C Flags，添加命令“-fembed-bitcode”。同样的设置在PROJECT中。如果不进行以上操作。别人在集成你的framework时可以编译，亦可以真机测试。唯独在打包时会发出警告并打包失败。警告为framework不支持bitcode！

10、无论SDK还是Framework都需要暴露公共的头文件以供使用者读取和。在TARGETS->Build Phases->Headers里面，有三种类别。Public(公共的)，这里存放供其他人查看的header。Private(私有的)这里存放私有的Header，以上两个Headers存放位置都会暴露出来，所有人可以查看。有些Header是不想给别人看到的。这种header放在第三个类Project中。

11、打包。Edit Scheme->Build Configuration->选为Release

12, 先选择任意模拟器com+B一次, 再选择真机com+B一次, 

13, 在XCode中选中相应的framework然后右键, show in finder,  打开终端输入

 lipo -create 模拟器SDK/SDK 真机SDK/SDK -output 桌面文件夹

 就可以将两个SDK合并 并导出使用了

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

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