经过构建Cocoapods私有库进行组件化开发探索

专题一

1、建立私有索引库

   选Github或者码云均可以，本例以Github为例。建立私有索引库用来做为本身组件库的索引：

2、本地添加私有索引库

添加：pod repo add 索引库名称 索引库地址

例：pod repo add ZYHModule https://github.com/zyhDeveloper/ZYHModule.git

查询：pod repo

3、建立组件库（同步骤一操做，在Github或者码云上建立）

4、建立组件工程

一、快速建立模版库

在命令行工具里cd进入桌面文件夹

执行：pod lib create 组件名

例：pod lib create XXModules

二、添加组件内容

咱们把基础组件相关的东西丢到Classes文件夹中，而且把ReplaceMe.m文件删除

执行：

git rm XXModule/Classes/ReplaceMe.m

git add .

git commit -m  'firstCommit'

三、安装与测试本地库

在Example项目的Podfile文件中能够看到 “  pod 'LXFBase', :path => '../'  ”，模板库已经默认帮咱们在Podfile中指定了LXFBase.podspec的位置，咱们无需操做，直接在命令行工具里cd到Example文件夹，执行pod install

 

四、 修改Spec

5、上传组件代码

一、将代码提交到组件仓库

git add .

git commit -m 'firstCommit'

git remote add origin https://gitee.com/LinXunFeng/LXFBase.git

git push -f origin master

二、打标签

标签与spec中的s.version保持一致

git tag -a 0.1.0 -m "Release version 0.1.0"

git push origin --tags

6、提交podspec到私有索引库

先作个本地和远程验证

一、本地验证

pod lib lint --allow-warnings

二、远程验证

pod spec lint --allow-warnings

三、提交podspec

执行： pod repo push 私有索引库名称 spec名称.podspec

pod repo push ZYHModule XXModule.podspec --allow-warnings

7、使用私有库

测试下搜索咱们的组件：pod search XXModules

一、添加Podfile文件

cd到开发的项目工程文件

执行：pod init

二、在Podfile的最顶部添加以下描述

// 第二行是为了保证公有库的正常使用

source 'https://github.com/zyhDeveloper/ZYHModule.git'

source 'https://github.com/CocoaPods/Specs.git'

添加：pod 'XXModules'

三、安装组件

执行：pod install

专题二

1、私有库的更新迭代

更新远程私有仓库

一、代码变更更新

组件库当有新增文件或者发生修改或者删除时，更新迭代执行：

删除：git rm XXXX

git add .

git commit -m '更新描述'

git push origin master

二、版本更新

版本更新 这一步很是重要，为更新索引库作准备

git tag -a 0.2.0 -m "Release version 0.2.0"

git push origin --tags

修改描述文件并更新索引库

一、修改spec文件

打开你的xx.podspec文件，将本来的版本号改成0.2.0，与刚刚的tag保持一致

git add .

git commit -m '更新描述'

git push origin master

二、验证Spec

pod spec lint --allow-warnings

三、更新索引库

// pod repo push 索引库名称 xxx.podspec

pod repo push ZYHModule XXModule.podspec --allow-warnings

最终需更新使用

pod update 

2、子库Subspecs的使用

    若是咱们只须要用到SDWebImage中的GIF功能，那么并不须要将整个SDWebImage都下载下来，在Podfile中将~~pod 'SDWebImage'~~ 改成 pod SDWebImage/GIF便可单独使用这一功能。

子库格式

s.subspec '子库名称' do |别名|

end

  使用说明：

s.source_files = 'XXModule/Classes/*'
# s.dependency 'SDWebImage', '~> 4.3.3'主库的依赖库

s.subspec 'Cache' do |c| 
c.source_files = 'XXModule/Classes/Manager/**/*' 
c.dependency 'SDWebImage', '~> 4.3.3' 子库的依赖库
end 

s.subspec 'Manager' do |m| 
m.source_files = 'XXModule/Classes/Category/**/*' 
end

修改后再按以前的步骤更新索引库和组件库就能够了

pod spec lint --allow-warnings(若是文件路径没问题，出现The`source_files` pattern did not match any file可尝试新设置tag)


pod repo push ZYHModule XXModule.podspec --allow-warnings

pod update

如需在某个工程添加子库，可执行：

pod 'XXModule/Manager'

pod install

专题三

资源文件的使用

资源文件都放在Assets文件夹中

1、修改Spec

将关于资源加载的注释去掉

s.resource_bundles = {

      # 'LXFMain' => ['LXFMain/Assets/*.png']

      改成：'LXFMain' => ['LXFMain/Assets/*']

}

2、修改加载资源代码

使用[UIImage imageNamed:@"图片名称"]加载不出来图片

使用如下代码：

NSString *normalImgName = [NSString stringWithFormat:@ "%@.png", normalImg];

NSBundle *curBundle = [NSBundle bundleForClass:self.class]; 

NSString *curBundleName = curBundle.infoDictionary[@"CFBundleName"];

NSString *curBundleDirectory = [NSString stringWithFormat:@"%@.bundle", curBundleName];

NSString *normalImgPath = [curBundle pathForResource:normalImgName ofType:nil inDirectory:curBundleDirectory];

UIImage *normalImage = [UIImage imageWithContentsOfFile:normalImgPath];

 

 

Xib的加载也是如此

NSBundle *curBundle = [NSBundle bundleForClass:self.class];

CustomView *customView = (CustomView *)[curBundle loadNibNamed:@ "CustomView" owner:nil options:nil].firstObject;

centerView.frame = CGRectMake(30, 140, 200, 100);

[self.view addSubview:customView];

若是是直接在xib中拖入一个imageView控件来设置图片的加载，咱们则须要在图片名字前加上当前bundle名称   XXXX.bundle/图片名字

专题四

本地私有索引库路径：/Users/Mr.z/.cocoapods/repos

 删除私有索引库：

pod repo remove [索引库名称] //移除本地索引库