目录
__封装静态库基础知识
_____1. 新建静态库项目
_____2.添加头文件
_____3.编译静态库
_____4.合并静态库
__封装静态库进阶
_____1.静态库中使用分类category
_____2.静态库中的图片处理
_____3.静态库中使用了xib
_____4.静态库中引用了第三方库
_____5.静态库调用目标工程中的方法
封装静态库基础知识
1. 新建静态库项目
新建一个 .a的静态库,注意名称一定不能包含中文。
2. 添加头文件
新建一个工具类，例如WYTTools.h 。
添加WYTTools.h 头文件到静态库。
3. 四次编译
编写好静态库的代码后，需要分别编译四次：真机-debug、真机-release、虚拟机-debug、虚拟机-release。这样我们可以得到以下的文件目录：(项目目录-products下的 ***.a 文件右击，show in finder)
模拟器/真机 下编译
真机：选择generic iOS Device
模拟器： 模拟器列表里随便选择一个即可，比如iPhoneSE
debug/release 下编译
product-scheme-edit scheme
4. 合并
4.1. 如何合并
lipo -create moniqi_debug.a zhenji_debug.a -output new.a
4.2. 需要注意
debug_真机 和 release_真机是无法合并的,同理,debug_模拟器 和 release_模拟器也是无法合并的。
将release_真机 和 release_模拟器 合并 得到的新包就可以在 release 的 真机和模拟器 下运行。debug同理。
2018.08.01:
发现一个问题: release_真机(Generic iOS Device)和release_模拟器的两个静态库合并, 得到的静态库就包含了全部四个架构了(i386 armv7 x86_64 arm64)
lipo -info xxxxxx.a
Architectures in the fat file: xxxxxx.a are: i386 armv7 x86_64 arm64
4.3. 合并或不合并的优缺点
不合并架构: 缺点: 需要手动切换,不方便 优点:体积小
合并架构: 与 不合并架构 相反
如果是一个比较大型的SDK,单据一个架构的体积就已经很大了(例如百度地图),不建议再合并架构了
如果合并架构,则不需要再同时导入 真机和模拟器两个架构了,一个就可以搞定,但是体积也会增大
封装静态库进阶
以上说明是静态库的简单封装, 但在面对实际需求时, 我们往往会面对更多更复杂的问题, 以下部分是我在做静态库封装, 为其他公司提供可用的sdk时遇到的一些比较复杂的问题, 总结以供参考, 留作备忘.
问题1. 静态库中使用分类category
静态库工程中使用分类再正常不过了, 但是打出来的sdk给程序使用时报错: 提示找不到静态库中引用的分类中的方法.
这时需要引用sdk(静态库)的工程 添加 -all_load 配置. 即在对应target的"Build Settings"中的“Other Linker Flags”选项添加“-all_load”。
问题2. 静态库中的图片处理
在静态库中使用本地图片, 如果使用[ UIImage iamgeNamed:@""] 方法, 静态库将无法加载到图片. 这时候我们需要在静态库工程中建立一个bundle文件, 将所有的资源图片放到bundle中, 然后再从bundle中加载图片.
#define ZFBundle_Name @"MySDKBundle.bundle"
#define ZFBundle_Path [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:ZFBundle_Name]
#define ZFBundle [NSBundle bundleWithPath:ZFBundle_Path]
//获取bundle 中的图片
+(UIImage *)inBundleImageNamed:(NSString *)imageName{
UIImage *image = [UIImage imageNamed:imageName inBundle:ZFBundle compatibleWithTraitCollection:nil];
return image;
}
//获取bundle 中的某个文件夹中的图片
+(UIImage *)inBundleImageNamed:(NSString *)imageName inFolder:(NSString *)folder{
NSString *path = [ZFBundle pathForResource:folder ofType:nil];
NSString *iamgePath = [path stringByAppendingPathComponent:imageName];
if (!iamgePath) {
return nil;
}
UIImage *image = [UIImage imageWithContentsOfFile:iamgePath];
return image;
}
问题3. 静态库中使用了xib
静态库中使用xib是一个比较麻烦的问题, 如果不做处理, 在打包静态库时会报错. 网上处理xib的方法很多, 不过很多方法很繁琐, 我使用了这样的方法.
通过以下命令将xib编译成nib文件:
ibtool --errors --warnings --output-format human-readable-text --compile xxxx.nib xxxx.xib
将编译出来的nib放到 静态库的 资源文件夹(Resource文件夹, 和Bundle文件同级)中便于管理.
然后注册和加载xib文件时, 只需要从资源文件中找到nib文件然后进行注册加载即可:
以前加载xib的代码:
[self.view registerNib:[UINib nibWithNibName:cellID bundle:nil]
现在改成加载nib的代码:
NSString *nibStr = [[NSBundle mainBundle] pathForResource:@"xxxxxx.nib" ofType:nil];
NSData *nibData = [NSData dataWithContentsOfFile:nibStr];
UINib *nib = [UINib nibWithData:nibData bundle:[NSBundle mainBundle]];
[self.view registerNib:nib forCellWithReuseIdentifier:cellID];
注释: 为什么要编译成nib文件: nib文件是xib的二进制文件(不可编辑), 防止外部更改 xib的内容
问题4. 静态库中引用了第三方库, 这些库可能会与引用静态库的工程中的库发生冲突.
这个问题是个很麻烦的问题, 我们打包静态库给别人使用, 一定要避免把第三方库打包到静态库中去的情况, 因为任何一个人, 引入你的sdk以后出现和自己工程里的库冲突的时候, 这个人都会骂这个做sdk的人sb的, 难道老子用你一个sdk, 还要删自己的库?
代码在往静态库打包工程中引入时, 应该分两个文件夹, 一个文件夹放需要打入静态库的功能代码, 这个文件夹在引入时, 勾选target. 然后将资源文件, 第三方库这些不需要编译到静态库中的文件放到一个lib文件中, 将lib文件夹拖入静态库打包工程中时, 不要勾选target. 这样, lib文件中的所有文件将不会被打包到静态库中.
经过上一步处理, 我们在提供给被人sdk时, 把.a静态库和lib文件夹同时提供, 如果引入工程中存在三方库冲突, 开发人员就可以自行删除lib文件夹中冲突的三方库即可.
问题5. 变态问题 之 静态库调用目标工程中的方法
这个问题不是标准的静态库打包问题. 但是人在江湖漂, 什么问题都是有可能的.
情景还原: a公司负责开发某大型国企单位的app, 但是该大型国企却将app中某个模块功能承包给b公司开发. b公司开发该功能后不可能将源码给a公司, b公司决定将功能打包成静态库发送给a公司进行融合. 这其间边涉及到b公司开发功能时要用到app工程中的部分方法, 即为在静态库调用目标工程中的方法
方法1. performSelector
Class class = NSClassFromString(Class_Name);
SEL selecotor = NSSelectorFromString(SEL_Name);
if (class && [class respondsToSelector:selecotor]) {
NSString *string = [class performSelector:selecotor withObject:obj];
}
适用于: 调用的方法 无参数/一个参数/两个参数.
方法2. NSInvocation
Class class = NSClassFromString(Class_Name);
SEL selecotor = NSSelectorFromString(SEL_Name);
@try {
NSMethodSignature *signature = [class methodSignatureForSelector:selecotor];
NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:signature];
[invocation setTarget:class]; //类方法,所以传的是class
[invocation setSelector:selecotor];
//传参数: 第一个参数的index从 2开始(0和1被占用了)
if (obj1) {
[invocation setArgument:& obj1 atIndex:2];
}
if (obj2) {
[invocation setArgument:& obj2 atIndex:3];
}
if (obj3) {
[invocation setArgument:& obj3 atIndex:4];
}
[invocation retainArguments];
//假设方法返回值是UIViewController. 如果不需要返回值或者无返回值, 不写此行代码
//__autoreleasing UIViewController *vc;
[invocation invoke];
//接收返回值. 如果不需要返回值或者无返回值, 不写此行代码
//[invocation getReturnValue:&vc];
} @catch (NSException *exception) {
NSLog(@"%s_%@",__func__,exception);
}
适用于: 参数比较多的方法
方法3. 引入头文件
最简单的方法, 和a公司索要你需要调用方法的头文件.h
当然, 如果a公司足够大方不拘小节, 说不定还会给你.m文件. 但是这都不是重点, 重点是, 这些工程中的文件, 需要同样放到之前说的lib文件夹中, 编译打包静态库时不能打进去. (当做第三方库对待).
这样, 有了头文件, 调用了方法在编译时就不会报错, 保证可以打包成功, sdk融入到app中后, 会执行app中的方法
