iOS功能模块封装SDK(静态库)
先说下封装SDK的使用场景:
比较常见的就是地图,视频播放器,数据统计这种功能性的SDK,做好后出售给其他公司使用,不能暴露源码;
其他情况就是解耦了,比如说当你的公司有很多个App,名字,电话,头像,身份证等没必要让用户在登录公司其它App的时候再设置一遍,也就是所有App共用同一个用户数据库,我们就可以开发一个私有库做组件,或者封装一个SDK
本文的例子就是封装一个登录的SDK
一、开发功能
首先把你想封装的代码准备好,比如说用户登录时需要的授权工具类,用户模型等等文件整理好放在一个文件夹里
二、创建静态库
1、创建IOS Framework工程
创建一个iOS的CocoaTouch工程,点击Next,输入我们Framework的名字即可。下方我们暂且将该Framework的名字命名为“Login”。
操作如下:
Xcode 一> File\New\Project 一> iOS\Framework &Library\Cocoa Touch Framework 一> 命名项目工程 一> 保存目录
2、设置最低支持的兼容版本:
创建完工程后,我们要选择“Deployment Target”, 此处我们选择的是8.0。也就是说此处我们封装的SDK所支持的iOS系统版本是iOS8.0+。
操作如下:
Xcode 一> Project 一> Targets 一> General 一> Deployment Info 一> ios8.0(最低支持的兼容版本)
3、配置静态库:
由于创建的framework默认是动态库,所以我们将Mach-O Type设置为静态库“Static Library”。
操作如下:
Xcode 一> Project 一> Targets 一> Build Settings 一> Mach-O Type 一> Static Library
4、导入源代码文件,设置文件权限:
将第一步准备好的SDK源代码引入到我们的Framework工程中进行编译,在编译之前我们要选择SDK用户可以看到的文件。是在Build Phases下的Headers中进行设置的。
将用户可以看到的头文件放在Public中,用户看不到的放在Project中。
操作如下:
Xcode 一> Project 一> Targets 一> Build Phases 一> Headers 一> Public/Private/Project
5、编译工程:
编译Framework工程前,需要设置Edit Scheme, 将Debug模式改成Release模式。
设置和配置完毕后,我们就要对我们的Framework工程进行编译了。先选择模拟器进行编译,然后连接真机,选择真机进行编译。
编译完后,在项目Products文件夹下会生成相应的Framework, 然后通过Show in Finder进行查看。
6、合并Framework库:
因为在模拟器下编译会生成模拟器下使用的Framework,在真机下编译会生成真机使用的Framework。如果想我们生成的Framework既可以在真机下使用,也可以在模拟器下使用,那么我们需要将两个Framework进行合并。
我们需要的是这两个文件:
来到终端:
输入 lipo -info 拖入真机上的这个文件路径 回车
结果:
前面的不用管,看最后 armv7 arm64 说明是真机,如此方法测试模拟器文件,需得到i386 x86_64才对。
确认两个文件无误之后,接下来合并:lipo -create 真机路径 模拟器路径 -output 真机路径
因为我们是合并到真机路径上,所以合并完成后需要按上面的方法进行测试,还是拖入真机路径,这时候需要得到的是:armv7 i386 x86_64 arm64
此时我们得到了我们需要的SDK了,这个SDK在模拟器上也能使用,在真机上也能使用了:
最终的SDK文件三、使用
我们把最终的SDK文件拖入我们想要使用的项目中就可以了
导入头文件方式
如果此时有警告“Missing submodule‘XXXX’”
记得在framework的总头文件中声明一下所有公开文件的头文件
系统的注释说的也很清楚了
// In this header, you should import all the public headers of your framework using statements like #import <Login/PublicHeader.h>