Guidelines for Creating Frameworks
1. 不问为什么上来就干,有问题最后再说
1.1 创建framwork工程
1.2 新建文件
这里用了‘SDWebImage’所以要pod一下(怎么pod百度一下哈),演示的功能是使用‘SDWebImage’里面的图片下载类 'SDWebImageDownloader' 来实现简单的图片下载.
1.2.1 添加类
/**
* 创建一个名叫‘SDWeImage’引用的类
* @author Roy CHANG
*/
@interface RCSDWebImgeRef : NSObject
///单独使用 sd 的 image downloader 下载图片,这个是要暴露给开发者使用的方法
+ (void)rc_downloadImage:(NSURL *)url completion:(void (^)(UIImage *image))completion;
@end
///下载图片实现
+ (void)rc_downloadImage:(NSURL *)url completion:(void (^)(UIImage *image))completion
{
if(!completion)
{
///什么都不做
return;
}
if(!url || ![url isKindOfClass:[NSURL class]])
{
completion(nil);
}
SDWebImageDownloader *_downloader = [SDWebImageDownloader sharedDownloader];
[_downloader downloadImageWithURL:url options:SDWebImageDownloaderLowPriority progress:^(NSInteger receivedSize, NSInteger expectedSize, NSURL * _Nullable targetURL) {
NSLog(@"\ndownload progress: %.2f.", receivedSize * 1.f / expectedSize);
} completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, BOOL finished) {
completion(image);
}];
}
1.2.2 编译源文件设置
1.要暴露给他人的文件 放在 ‘Public‘中,自己SDK内部使用的放在’Project‘中。
2.设置framework 为‘static library’
3. 编译环境设置
xcode 8.0 + 默认真机cpu架构已经包括 amrv7、armv7s、arm64。现阶段已经够我们测试用了。支持模拟器的我们待会儿再说....先解决主要矛盾。
到这里sdk的基本功能已经可以给真机使用了。
1.3 使用framework
右键点击'XXX.framework' -> 'Show In Finder' 复制出来添加到到工程中。
这里为了方便在‘framework’工程中添加了一个测试Target,然后在Demo Target中添加依赖编译时一起编译最后在使用的文件中导入framework头文件即可,如:
#import <MyFramework/MyFramework.h>
ps:实际使用中直接添加文件到工程即可。
Demo效果:
3. 常见问题
3.1 我该怎么同时支持真机和模拟器
1. 支持真机
编译然后‘show in finder’ 找到你的‘framework’文件复制出来,比如统一放到桌面 ~/Desktop/framework_sdk/ 文件夹下。本例命名为‘i_MyFramework.framework’.
2. 支持模拟器
把真机设置中‘Generic iOS Devices’ 换成模拟器就可以了!
编译然后‘show in finder’ 找到你的‘framework’文件复制出来,比如统一放到桌面 ~/Desktop/framework_sdk/ 文件夹下。本例命名为‘s_MyFramework.framework’.
3.合并SDK
打开终端,cd 到 ‘~/Desktop/framework_sdk/’文件夹下执行命令,本例为:
命令:lipo -create s_MyFramework.framework/MyFramework i_MyFramework.framework/MyFramework -output Myframework
~合并后的SDK,名字为:“MyFramework”
重要一步:随便复制一个framework,比如本例:“i_MyFramework.framework” 将其改名为“MyFramework.framework”然后将“MyFramework.framework”包里的“MyFramework”替换成合并后的“Myframework”.
4.查看cpu架构
命令:lipo -info xxx.framework/xxx,本例 lipo -info Myframework.framework/MyFramework
3.2 SDK中用到了分类在引用时程序崩溃
如果你的framework中用到分类,那么在引用SDK的工程里要添加链接符:"-all_load"
"-ObjC"有时也可以
Other Link Flags -> -all_load
3.3 我的SDK中引用了第三方库,我的主工程中也引用了同一个第三方库由此导致的文件冲突怎么办
这个问题确实有些蛋疼,我们一般的解决办法是:
1. 自己SDK中引用的第三方库重新命名... 比如‘SDWebImage’重新命名‘XXSDWebImage’这个就粗暴一些了...本例就是这么直接干的!
2. 添加SDK时不要选择 添加到 target中
3. 重新合并打包相关冲突的库
iOS解决两个静态库的冲突 duplicate symbol