iOS 封装成Framework

本文参考文章:iOS Xcode9 封装生成.framework - CocoaChina_让移动开发更简单


1.什么是库?

库是共享代码的方式分成静态库和动态库

静态库(.a和framework):链接时完整的拷贝到可执行文件,被多次使用就有多份冗余拷贝(我们自己建的framework是静态库 )

动态库(.dylib和framework):链接时不拷贝,程序运行时由系统直接加载到内存,供程序调用,系统只加载一次,多个程序共用,节省内存。(系统的framework是动态库 )

2. Framework与.a文件的区别?

.a文件是一个纯二进制的文件, 不能直接使用,至少要跟.h文件配合使用

framework除了二进制文件还有资源文件,可以直接使用,.a+.h+sourceFile=framework

建议使用framework

3.为什么要使用静态库?

1 方便共享代码,便于合理使用。

2 实现iOS程序的模块化。可以把固定的业务模块化成静态库。

3 和别人分享你的代码库,但不想让别人看到你代码的实现。

4 开发第三方sdk的需要。

4.制作静态库时的几点注意:

1 注意理解:无论是.a静态库还.framework静态库,我们需要的都是二进制文件+.h+其它资源文件的形式,不同的是,.a本身就是二进制文件,需要我们自己配上.h和其它文件才能使用,而.framework本身已经包含了.h和其它文件,可以直接使用。

2 图片资源的处理:两种静态库,一般都是把图片文件单独的放在一个.bundle文件中,一般.bundle的名字和.a或.framework的名字相同。.bundle文件很好弄,新建一个文件夹,把它改名为.bundle就可以了,右键,显示包内容可以向其中添加图片资源。

3 category是我们实际开发项目中经常用到的,把category打成静态库是没有问题的,但是在用这个静态库的工程中,调用category中的方法时会有找不到该方法的运行时错误(selector not recognized),解决办法是:在使用静态库的工程中配置other linker flags的值为-ObjC。

4 如果一个静态库很复杂,需要暴露的.h比较多的话,就可以在静态库的内部创建一个.h文件(一般这个.h文件的名字和静态库的名字相同),然后把所有需要暴露出来的.h文件都集中放在这个.h文件中,而那些原本需要暴露的.h都不需要再暴露了,只需要把.h暴露出来就可以了

从上面我们可以看出.a 和.framework的区别就是.a+.h+soureFile=.framework,这样的话,我们还是直接封装个.framework比较好


封装framework步骤

1、打开xcode,新建工程

这里我使用的是Xcode9,选择Cocoa Touch Framework,然后点next

iOS 封装成Framework_第1张图片

2、创建功能类或者拖入已有的功能类

这里我创建的是ShowResult类。

iOS 封装成Framework_第2张图片

3、实现功能类的功能

.h文件中

iOS 封装成Framework_第3张图片

.m文件中

iOS 封装成Framework_第4张图片

4、更改Xcode项目配置

在TARGETS下选中工程>Build Setting>搜索linking,然后几个需要设置的选项都显现出来。

1、首先是Dead Code Stripping设置为NO,网上对此项的解释如下,大致意思是如果开启此项就会对代码中的”dead”、”unreachable”的代码过滤,不过这个开关是否关闭,似乎没有多大影响,不过为了完整还原framework中的代码,将此项关闭也未曾不可。

2、然后将Link With Standard Libraries关闭,我想可能是为了避免重复链接

3、最后将Mach-O Type设为Static Library,framework可以是动态库也可以是静态库,对于系统的framework是动态库,而用户制作的framework只能是静态库。

iOS 封装成Framework_第5张图片

5、增加armv7s

iOS 封装成Framework_第6张图片

更改后:

设置Headers

将你要公开的头文件拖至Public下,要隐藏的放在Private或者Project下,当然,隐藏的头文件就无法再被引用。

iOS 封装成Framework_第7张图片

然后需要在FrameworkTest.h(必须是公开的,否则无法引用)中将你所有要公开的.h引入。

iOS 封装成Framework_第8张图片

打包

打包有两种方式 一种是手动打包,另一种是用脚本,这里我用手动打包的方式。

1、选中模拟器,编译程序command+B

2、选中测试机,编译程序command+B

3、在finder中找到framework文件

iOS 封装成Framework_第9张图片

找到下图中的FrameworkTest文件,这里有两个同名文件,一个是Debug-iphoneos(真机)下的,一个是Debug-iphonesimulator(模拟器)下的。

iOS 封装成Framework_第10张图片

4、通过终端命令将两个framework合为一个模拟器和真机都可使用的framework。

打开终端,输入lipo -create命令,将

Debug-iphoneos下FrameworkTest.framework目录下的FrameworkTest文件

拖拽到终端中,会自动有空格。然后将Debug-iphonesimulator下FrameworkTest.framework目录下的FrameworkTest文件

iOS 封装成Framework_第11张图片

拖拽进来,也会自动有空格,然后输入 -output,敲空格,在引入一个新的路径。最后敲回车,这样就合并了。

iOS 封装成Framework_第12张图片

上面这段命令就是把真机和模拟器中的FrameworkTest合并成一个新的文件放在和newTest同级的文件夹new下,这个新文件后缀是.lipo,并不是我们要的FrameworkTest文件,怎么办呢?我们的操作是按照人家说的把合成后的文件名字改成FrameworkTest替换原来的。而且,把后缀.lipo去掉!然后将新生成的这个FrameworkTest替换 原来的FrameworkTest(是指同时替换掉模拟器跟真机里面的FrameworkTest文件)。进行下一步。

这里终端会有一个error

error: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/lipo: can't move temporary file: /Users/lgj/Desktop/new/newTest to file: /Users/lgj/Desktop/new/newTest.lipo (Is a directory)

5、将修改后的framework拷贝出来就是我们最终制作的framework了。

iOS 封装成Framework_第13张图片

使用

将我们封装的framework拖拽到新的工程里面。

iOS 封装成Framework_第14张图片

我们打开这个framework看看,发现只有Headers,里面有两个.h,其中一个是FrameworkTest.h另一个就是ShowResult.h文件。

iOS 封装成Framework_第15张图片

引入头文件:

iOS 封装成Framework_第16张图片

运行得到[ShowResult show];的结果

至此,完成framework的封装和使用。

总结

1、在制作framework或者lib的时候,如果使用了category,则使用改FMWK的程序运行时会crash,此时需要在该工程中 other linker flags添加两个参数 -ObjC -all_load。(这点没有亲测)

2、带有图片资源的需要把图片打包成Bundle文件,和framework一起拷贝到相应的项目中。

3、公开的类中如果引用的private的类,打包以后对外会报错,找不到那个private的类,可以把那个private的.h放到(也没亲测)

4、namespace 冲突。静态库用了某第三方库,项目也用了同样的第三方库,在编译的时候就会有 duplicate symbol 错误,因为有两份同样的第三方库。解决办法就是把用到的第三方库加上自定义前缀,包括类名、delegate 协议、常量名,尤其需要注意 Category 的方法名要修改。

5、图片等资源文件用 bundle 方式打包。一个简单制作 bundle 的方法:新建文件夹,重命名为 YourSDK.bundle,然后 Show Package Contents 打开,加入图片。使用图片的时候需要指明 bundle: [UIImage imageNamed:@"YourSDK.bundle/img.png"]。也可以用 Target 方式制作 bundle,比如 iOS Library With Resourceshttp://www.galloway.me.uk/tutorials/ios-library-with-resources/.

源自:https://www.jianshu.com/p/87dbf57cfe4a

你可能感兴趣的:(iOS 封装成Framework)