背景
最近入职了一家新公司,进来之后分配到的任务是为公司APP和客户做插件化服务(勘误:在ios中说插件化,怕是要翻水水),也就是做SDK开发.之前开发APP的时候总是吐槽别人家的SDK很难用,各种使用上的坑.现在轮到自己来做了,心里难免会有一种翻水水的感觉,哈哈......
初识SDK
iOS中SDK开发通常有两种方式:
StaticLibrary
Framework
至于如何创建StaticLibrary和Framework的方法这里就不细说了.我这里采用的Framework的方式来开发,原因是Framework只会加载一次,比较省空间(移动设备的内存通常都是比较珍贵的).
其中Framework工程的BuildSetting中Mach-O Type 设置为 Static Library;
开发过程
-
当我创建好一个framework工程之后,我编写了一些简单的代码用来测试,如下图:
测试代码.png
功能是:电话号码和密码有为空的情况就弹出一个警告框,并且回调一个bool值判断是否登录成功.
-
经过编译之后在Products文件下可以看到framework已经生成了:
然后找到framework的生成文件,拖入到实现准备好的测试demo项目.
- 在测试demo的ViewController.m文件中,我导入了测试的头文件MenuSDK.h,调用了framework中的方法,然后运行.
点击登录之后按道理应该会有弹窗的出现提示为空的,这里却并没有显示,这里是用sb拖入控件的方式.
那么问题来了
- 问题一:利用xib或者sb拖入的UITextField控件默认值是
@"",而不是nil,所以我判断的方式if(!text)有问题,于是加了不为@""的情况,然后我在framework工程中更改代码之后,重新编译,然后又拖到demo工程中,运行之后点击,效果出现了.嗯,很开心. - 问题二:在这个过程中,每次修改完framework代码之后都需要重新编译并且将包拖入到demo工程中,如此反复几次之后,简直深恶痛绝,这样搞会让人崩溃的!
如果把framework工程和demo工程一起管理,编译demo工程的时候framework工程就自动更新好了那该多好!
问题二解决方式:
(1) 打开demo工程,File->New->Workspace,新建一个workspace,用来管理demo和framework.
(2) 这时候会出现一个空白的workspace界面,先不动它.关掉demo和framework工程,将两者根目录下的xcodeproj拖入到刚刚新建的workspace工程中,如下图:workspace
(3)在demo的target中Embedded Binaries和Linked Frameworkd and Libaries都要添加MenuSDK.framework
(4) 这时运行会报错,找不到头文件MenuSDK.h,因为在demo的build setting中没有指定header search paths,双击后面的空格,将MenuSDK.framework的Headers路径拖入其中即可,因为在framework中头文件都是在Headers目录下:
最后成功运行!于是就完成了demo和framwork的统一管理,极大方便了SDK的开发和调试.
- 问题三:本来以为将两者统一到workspace中就基本没啥问题了,但是后来手贱搞了
一个分类到framework中,然后呢,奇怪的一幕发生了,当我将分类import到.m文件里时,编译没问题.后来想到improt到.h中更好,于是顺利的按照提示import了,但这时候报错了,说找不到分类文件......气哭!好吧,还是import到.m中,这下总没问题了吧.运行,报错,定位到使用分类方法的位置,提示:Unrecognize selector.......
这里有两个点:
1.为啥import到.h文件中找不到分类
2.导入.m文件中后方法未识别.
解决方式:
咨询了一位搞SDK的老司机之后,他回复了一句话:-ObjC,专治分类.恍然大悟,于是立马去framework的buildSetting中设置other link flag为-ObjC,问题解决,分类也可以使用了.心中一万只那啥跑过......猜测一下原因应该是分类是属于OC独有的语法特性,所以需要指定-ObjC,额,我能想到就只有这么多了.
- 问题四:framework通常是搭配bundle来使用的,
并且苹果不允许将bundle打进framework包里.那如何使用bundle管理资源文件(图片,音频等)呢?
创建bundle有两种方式:
(1) xcode里面setting bundle
(2) 新建一个文件夹,放入资源文件,然后修改后缀为.bundle
这里我采用的是第二种方式.将bundle拖入到项目中.但是由于是将资源放入了bundle中,那么读取文件的方式就不同了,以图片为例:
就需要取到bundle的path来读取了.
以上就是这两天研究SDK开发遇到的一些实际问题,路才刚刚开始,希望自己以后的SDK开发之路一(坎)路(坷)顺(不)利(断).
最后鸣谢罗老板给与的无私帮助!
9-4日更新:
当我们需要在SDK中集成其他sdk的时候,例如我的sdk中接入微信支付的SDK,那么这个时候我们需要将wxpay.a以及header拖入到我们项目中,引入依赖库即可.
但是,如果需要集成的是framework的话,亲测,直接拖入framework集成暂时不可行(不知道是我哪里搞错了没),于是乎查阅了网上的资料,发现framework只是对.a文件的一次封装,我们只需要将framework中的二进制文件:
添加一个后缀.a,同时将这个转换的.a文件拖入Headers中,最后将这个Headers文件拖入你的SDK项目中,添加依赖文件即可引用.如下图效果:
2018-3-27补充:framework中如何做到不直接依赖AFN等三方库
1.首先我们新建一个Lib的framework,里面放入AFN等三方框架,建议是直接拖入代码.如下图:
此时我们需要去target里面配置Build phases,将AFN所有的头文件全部设置为public(很重要):
2.我们再建立我们自己的framework Task,里面放入业务代码.然后建立一个workspace,workspace位置可以放在Task工程目录中,同时导入lib和Task:
并且Task中关联lib.framwork:
接着在build setting里面设置framwork search path lib的framwork地址,header search path为lib framwork的headers地址.
最后在我们的业务里面可以直接导入三方的头文件,使用即可:
