iOS SDK 静态库.framework打包流程及注意事项

    由于公司需求,第一次接触静态库制作和打包。不懂就查,看了很多别人的写的文章,都是大概的几个步骤,然后再附一个简单的demo实现。看完感觉有点也不难,但是实际操作的时候,就容易想很多,比如pch文件怎么弄?资源文件怎么搞?依赖三方怎么办?

    于是硬着头皮开始尝试,踩着别人的方法慢慢摸索。索性也还好,没多久就搞出来了,想了很久,还是准备写一下这个流程,让自己加深下记忆,也给有需要的人提供一点点帮助。我就不讲什么静态库动态库的区别啥的,网上一搜一大堆,我直接开始进入正题。

1.整理你需要打包的代码

    (1).整理图片资源。图片资源需要整理出来,打成一个.bundle包(如何打自行百度,我这里直接修改文件夹后缀即可),然后在用图片获取imageWithName:这种方法时,不能直接写一个图片的名称,而是需要根据拼出图片的完整路径,并且在原来项目中,系统会自动去读取2x和3x的图片,但在这里需要自己做一下处理。实现原理自己去百度吧,我这里直接贴代码,需要自取。

+ (UIImage*)getImageWithName:(NSString*)imageName

{

    NSString*imageStr =@"";

    CGFloat scale = [UIScreen mainScreen].scale;

    if(ABS(scale -3) <=0.001) {//返回3x图

        imageStr = [NSStringstringWithFormat:@"%@@3x",imageName];

    }else{//返回2x图

        imageStr = [NSStringstringWithFormat:@"%@@2x",imageName];

    }

    NSString *bundleStr = [[NSBundle mainBundle] pathForResource:@"xxxxxx" ofType:@"bundle"]; //其中xxxxxx为你之前打的bundle包的名字

    NSString *imagePath = [[NSBundle bundleWithPath:bundleStr] pathForResource:imageStr ofType:@"png"];

    return[UIImageimageNamed:imagePath];

}

    (2).准备需要打包的代码。由于我的需求是把已有的功能从旧项目中剥离开来打包成静态库即可,所以不需要从头开始写,但是由于一些代码耦合的原因,并且借鉴了一些大佬封装SDK的思想,我还是打算给予现有的代码,重新进行构思。这里推荐一篇大神的文章:iOS SDK开发经验分享 - ,这里很好的提供了SDK的制作的思想,反正我看了收获还是不少的。准备好代码,那么我们就可以进行打包静态库了。接下去的步骤就比较常规。

2.静态库.Framework 打包

    (1)新建一个framework工程

创建framework工程

(2)在BbuildSettings中,设置成静态库,添加armv7s架构;在General中设置最低支持版本;

设置基本参数


添加armv7s
设置SDK最低支持版本

(3).导入已经写好的代码(包括.pch文件),注意这里图片资源.bundle不要导入,另外,如果是你依赖的三方是拖入项目中的,例如AFNetworking,需要先从项目中Remove References,然后再添加,添加时 Add to targets 的选项把勾去掉。这样就不会把三方打包到静态库中,避免其他人在使用SDK的时候产生冲突。但是这样的前提是需要对方在使用SDK的时候主动添加这个SDK所需要的三方库。

不要添加

(4).设置header,把你想暴露的.h文件放到public中,这里要提到一下,在工程一开始创建的时候,系统会自动生产一个.h文件和.m文件,有些文章说要把暴露的头文件引入到系统生产的.h文件中,然乎在把这个头文件添加到public中。我个人觉得如果头文件多,那么可以这么操作,如果头文件少的话,也没必要这么操作,直接删除都是没有问题的。


设置公开的.h文件

    (5).开始打包,选择真机和模拟器各打一次Release包。注意:真机的包target选择Generic iOS Device,不能连着自己的真机打包,否则打出来的framework不能支持全机型。模拟器打包则可以选择任意机型。


打包注意

    (6).合成最终的.framework。在Products中找到.framework,然后show in finder 找到刚才打打Release版本的真机和模拟器包。然后新建一个文件夹,在终端中cd到该文件夹下,然后执行lipo -create 模拟器framework的路径 真机framework的路径 output xxxx(framework的名字,和之前的工程名字相同),这样就能在刚刚新建文件夹中找到合成的xxxx。然乎用这个xxxx文件替换真机framework里面的同样名字为xxxx的文件,那这个真机的.framework就是最终的静态库。我们可以在终端中lipo -info 查看合成的xxxx文件,看是否支持armv7 armv7s i386 x86_64 arm64 这五项。


系统生产的framework


合成framework

(7)复制一份替换了文件的真机.framework,并把之前图片的.bundle放在统一文件夹下,这样静态库就打包好了,可以给在别的项目或者提供给别人使用了。


最后的样子

你可能感兴趣的:(iOS SDK 静态库.framework打包流程及注意事项)