Cocoapods 管理本地私有库

用 Cocoapods 管理本地库

众所周知,我们在写SDK时，会考虑尽量避免使用第三方库，尽量给自己的类名或图片名起的特别一些，比如加"NS"前缀等，这些都是为了避免一个问题（冲突），但我们也会发现，Cocoapods引入得第三方库为什么不会冲突，这就是私有库的魅力，下面开始学习如何从零构建一个可以使用的本地私有库，希望以后能多和广大开发者交流技术,共勉!



学习从创建主工程开始，到完美调用为止，执行一遍完整的流程。

1. 创建Demo工程

首先，创建一个名为Another的工程，如图

私有库Demo

随后我们打开终端，cd到工程目录下，为这个工程初始化一下Cocoapods

到当前目录下
cd /Users/XXX/Desktop/Another
执行pod初始化
pod init

然后工程变成如图的样子

pod初始化后

2. 创建本地私有库

接着我们利用pods创建私有库

pod lib create DemoPrivateSDK

不出意外，会出现如图所示的询问指令，根据需要回答即可

终端创建本地私有库的过程

按下回车，本地私有库就创建好啦，此时会自动弹出一个Example工程如图所示

自动创建好的Example工程

可以在这里开发我们的SDK，当然，我们直接把私有库链接到主工程，在主工程里开发岂不是更好。

3. 将本地私有库链接到Demo工程

接下来我们要把本地私有库链接到Demo工程中。

打开终端，在当前工程目录下输入
vim podfile

然后在出现的podfile中输入如图字样

image.png

即下面这句话
pod 'DemoPrivateSDK', :path => 'DemoPrivateSDK'

pod后是本地私有库的名字，path后面是本地库相对于podfile的相对地址。
输入完以后，我们:wq保存一下，接着执行

pod install

打开工程如图所示

链接完本地库的主工程

此时我们还差一步就大功告成啦。

4. 加载资源文件

我们先看一下咱们的podspec

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文件了

image.png

把这个文件复制到Assets目录下，即如图位置

image.png

右键，显示包内容，将资源文件赋值到bundle里即可，如图。

image.png

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

运行，出现如图所示

Simulator Screen Shot - iPhone 11 Pro Max - 2020-01-15 at 12.32.26.png

ok，图片成功加载出来。

以上就是Cocoapods创建本地私有库的全过程，加油