用 Cocoapods 管理本地库
众所周知,我们在写SDK时,会考虑尽量避免使用第三方库,尽量给自己的类名或图片名起的特别一些,比如加"NS"前缀等,这些都是为了避免一个问题(冲突),但我们也会发现,Cocoapods引入得第三方库为什么不会冲突,这就是私有库的魅力,下面开始学习如何从零构建一个可以使用的本地私有库,希望以后能多和广大开发者交流技术,共勉!
学习从创建主工程开始,到完美调用为止,执行一遍完整的流程。
1. 创建Demo工程
首先,创建一个名为Another
的工程,如图
随后我们打开终端,cd
到工程目录下,为这个工程初始化一下Cocoapods
到当前目录下
cd /Users/XXX/Desktop/Another
执行pod初始化
pod init
然后工程变成如图的样子
2. 创建本地私有库
接着我们利用pods创建私有库
pod lib create DemoPrivateSDK
不出意外,会出现如图所示的询问指令,根据需要回答即可
按下回车,本地私有库就创建好啦,此时会自动弹出一个Example
工程如图所示
可以在这里开发我们的SDK,当然,我们直接把私有库链接到主工程,在主工程里开发岂不是更好。
3. 将本地私有库链接到Demo工程
接下来我们要把本地私有库链接到Demo工程中。
打开终端,在当前工程目录下输入
vim podfile
然后在出现的podfile中输入如图字样
即下面这句话
pod 'DemoPrivateSDK', :path => 'DemoPrivateSDK'
pod
后是本地私有库的名字,path
后面是本地库相对于podfile的相对地址。
输入完以后,我们:wq
保存一下,接着执行
pod install
打开工程如图所示
此时我们还差一步就大功告成啦。
4. 加载资源文件
我们先看一下咱们的podspec
可以看到在
podspec
中,可以利用source_files
指定要编译的源代码文件。但当将图片、plist、xib等资源打包进Pod
时该怎么办呢?这时,我们就要利用
resource_bundles
,Cocoapods
会在这个地址下创建一个名为DemoPrivateSDK
的bundle
文件,我们可以将资源文件放到这里面,接下来具体操作一下,这里以图片距离,xib、plist
等资源文件的操作是一样的。4.1 在podspec
中输入下列语句
s.resource_bundles = {
'DemoPrivateSDK' => ['DemoPrivateSDK/Assets/*.bundle']
}
这句话的作用是,在工程中生成一个bundle
文件,稍后可以在Product
中找到这个bundle
文件。
4.2. 而后执行pod install
这时就可以在Products中看到DemoPrivateSDK.bundle
文件了
把这个文件复制到Assets目录下,即如图位置
右键,显示包内容,将资源文件赋值到
bundle
里即可,如图。4.3. 继续编辑podspec文件
现在bundle文件已经打包好了,注释掉s.resource_bundle
,并添加下列语句
s.resource = "DemoPrivateSDK/Assets/*.bundle"
这句代码的意思是告诉系统我的资源文件放在这个bundle里面啦。
4.4 调用资源文件
拿图片举例子,我们不能像主工程那样直接用[UIImage imageNamed:@"xxx"]
,因为imageNamed
方法默认查找的是mainbundle
下的资源文件,而我们需要先找到自己的bundle文件,再去调用,为了方便我们写两个分类。
首先是查找bundle
的分类
#import "NSBundle+Library.h"
#import "MEFunnyButton.h"
@implementation NSBundle (Library)
+ (NSBundle *)myLibraryBundle {
return [self bundleWithURL:[self myLibraryBundleURL]];
}
+ (NSURL *)myLibraryBundleURL {
NSBundle *bundle = [NSBundle bundleForClass:[MEFunnyButton class]];
return [bundle URLForResource:@"DemoPrivateSDK" withExtension:@"bundle"];
}
@end
其次是图片调用的分类
#import "UIImage+Library.h"
#import "NSBundle+Library.h"
@implementation UIImage (Library)
+ (UIImage *)bundleImageNamed:(NSString *)name {
return [self imageNamed:name inBundle:[NSBundle myLibraryBundle]];
}
+ (UIImage *)imageNamed:(NSString *)name inBundle:(NSBundle *)bundle {
#if __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_8_0
return [UIImage imageNamed:name inBundle:bundle compatibleWithTraitCollection:nil];
#elif __IPHONE_OS_VERSION_MAX_ALLOWED < __IPHONE_8_0
return [UIImage imageWithContentsOfFile:[bundle pathForResource:name ofType:nil]];
#else
if ([UIImage respondsToSelector:@selector(imageNamed:inBundle:compatibleWithTraitCollection:)]) {
return [UIImage imageNamed:name inBundle:bundle compatibleWithTraitCollection:nil];
} else {
return [UIImage imageWithContentsOfFile:[bundle pathForResource:name ofType:nil]];
}
#endif
}
@end
到这里,我们就把所有准备工作准备好了,现在创建一个Button
类试试。
@implementation MEFunnyButton
- (instancetype)initWithFrame:(CGRect)frame
{
self = [super initWithFrame:frame];
if (self) {
[self setImage:[UIImage bundleImageNamed:@"funny_close"] forState:UIControlStateNormal];
self.enabled = NO;
}
return self;
}
@end
按照如下方式调用
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
// Do any additional setup after loading the view.
MEFunnyButton *button = [[MEFunnyButton alloc] initWithFrame:CGRectMake(100, 100, 100, 100)];
[self.view addSubview:button];
}
@end
运行,出现如图所示
ok,图片成功加载出来。
以上就是Cocoapods创建本地私有库的全过程,加油