Cocoapods的使用原理
CocoaPods 是开发 OS X 和 iOS 应用程序的一个第三方库的依赖管理工具。利用 CocoaPods,可以定义自己的依赖关系 (称作 pods),并且随着时间的变化,以及在整个开发环境中对第三方库的版本管理非常方便。相比于手动导入框架(下载源码,导入项目,配置环境,添加依赖库,容易出错), 使用Cocoapods只需要简洁3步就可以引入一个第三方框架,一般情况下都不会出错。
第一步、终端进入项目路径下,使用命令pod init
,自动生成Podfile文件。
第二步、使用vim打开Podfile文件,加入你想要使用的开源库。(比如说AFN, 你可以使用 pod search AFNetworking
查询AFN的版本,选择一个合适的Version,然后添加 pod 'AFNetworking', '~> Version'
)
第三步、使用命令pod install
安装。
然后只需等待Cocoapods像魔法一样帮我们导入第三方框架,你就可以在项目中愉快的使用AFNetworking了。作为一个iOS开发者,Cocoapods的便利性相信每一个用过的开发者都爱不释手。
为什么我们仅仅在Podfile中引入框架的名称和版本,就能下载到位于Github仓库的框架代码,并导入到我们自己的项目中?
带着这个疑问,我们在Finder中进入~/.cocoapods/repos
路径下,可以看到repos路径下有一个master文件夹,其实这个master文件夹就是我们Cocoapods的开源库索引文件的本地仓库。
证实一下,终端下进入master路径,命令ls -a
,可以看到有.git文件,我们查看下它的远程仓库,使用命令git remote -v
,输出https://github.com/CocoaPods/Specs
,在浏览器中打开这个地址,这个就是Cocoapods的远程索引仓库托管地址The CocoaPods Master Repo
。我们在master目录中看到很多子文件夹,随便打开一个,一直找到尽头,会找到一个*.podspec.json
文件,这个文件就是一个第三方库的索引文件,我们打开这个文件,你就会看到相关的 name、version、homePage、git
等等相关的内容,这就是我们使用 pod search * 可以搜到指定的第三方库的原因。
如果你想更深入的了解Cocoapods的工作原理,可以参考:
ObjC中国 深入理解Cocoapods
Cocoapods 指南
私有仓库的搭建
根据上面的摸索,相信大概知道了Cocoapods的一个工作流程,那么我们搭建自己的私有仓库也是采用相同的思路,大概也是这三步:
1、创建自己的私有索引仓库。
2、创建自己的框架或者项目,将索引文件提交到这个私有索引仓库。
3、在需要使用的项目的Podfile文件中,导入私有索引仓库地址,即可使用。
Tips: 如果你同时需要使用其他开源框架,类似AFN等,必须将Cocoapods的索引仓库地址也导入,否则无法安装使用AFN。
Reason:默认情况下,不写source源的时候使用Cocoapods的索引仓库,而当你加入了你的私有索引仓库地址,pod就只会在你指定的索引仓库里面去找,当然是找不到AFN等开源框架的。
看起来好像很简单,那开始搭建我们的私有Cocoapods仓库吧!
准备工作:
1、一台能上网的mac电脑。
2、一个自己的git账号,什么git仓库都可以。
Tips: github的私有仓库好像是收费的,可以使用gitLab、gitee等,我使用gitee
步骤:
1、在gitee上面创建一个索引仓库JTSpecs。 (这里为了演示,我就设置为开源的,你可以设置为私有的)
2、在终端使用命令, 然后我们的
~/.cocoapods/repos
目录下会多出来一个JTSpecs本地索引仓库。
$pod repo add JTSpecs https://gitee.com/hjt_830/JTSpecs.git
JTSpecs本地索引仓库.png
3、终端进入到桌面路径,创建本地项目,pod将自动使用模板创建一个项目https://github.com/CocoaPods/pod-template.git
pod lib create JTTest
使用template创建项目2.png
项目结构.png
4、在gitee上创建一个远程JTTest仓库,终端进入JTTest的项目路径下,将项目push到远程仓库。
git remote add origin https://gitee.com/hjt_830/JTTest.git
Tips: 第一次pull项目的时候,会出现`refusing to merge unrelated histories`, 只需使用 `git pull origin master --allow-unrelated-histories`即可正确拉取,然后push。
5、进入项目路径下的 JTTest/JTTest/Classes
路径下,将里面的 ReplaceMe.m
文件替换为自己的文件。
6、XCode中修改 JTTest.podspec
文件。
Tips: 由于这个文件是ruby脚本,为了便于阅读和修改,我们选中这个它,并在右边的`Identity and Type`中的Type中,选择`Ruby Script`类型,然后随便选中其他某个文件,再选回`JTTest.podspec`,XCode可以正确显示内容了
这里面有几个地方需要注意:
s.public_header_files
是指你要给出的所有公共头文件的路径,你可以指定特定的头文件
s.frameworks
是项目中依赖的系统框架,比如说 UIKit、Foundation、CoreData
s.dependency
是指项目中依赖的第三方框架,比如说 AFNetworking,可以指定版本
s.ios.deployment_target
是你的库需要的最低系统支持版本
...
7、改完后,我们终端进入Example目录下,执行命令pod install
,等待执行完成,你会发现 AFNetworking 已经安装进去了。
8、本地校验,校验的是我们的JTTest.podspec文件,所以需要返回上级目录,执行命令 pod lib lint --allow-warnings --verbose
。
不出意外,会验证通过,如果这里验证失败的同学,看一下报错的原因,通常如果项目本身编译正确的话,那么就是 *.podspec文件里面的问题,而且每次对 Development Pods
目录下的文件和 *.podspec
文件做了任何的修改,都必须要再执行一次 pod install
命令,确保Development Pods
目录下的文件和 *.podspec
里面配置保持一致。
9、既然验证通过,那我们就提交本地代码,git push origin master
,然后一定要打标签,一定要打标签,一定要打标签,重要的事情说三遍,并且这个标签要和 *.podspec
中的 s.version
的版本保持一致。
10、最后一步,推送到我们的远程索引仓库,当然,推送之前你可以先远程校验一次,终端使用命令 pod spec lint --allow-warnings --verbose
,其实这个校验也可以不做,因为我们推送的时候也会做这个工作。下面就推送到远程索引仓库吧,终端使用命令 pod repo push JTSpecs JTTest.podspec --allow-warnings --verbose
,这里的 JTSpecs
是我们第二步中创建的索引仓库的名字,你替换成自己的就好了。
到这里基本就已经完成了私有仓库的搭建,使用的时候只需要在 Podfile
引入就可以了,当然记得加上:
source https://gitee.com/hjt_830/JTSpecs.git
(这个替换成你自己的私有索引仓库的地址)
source https://github.com/CocoaPods/Specs
(这个是Cocoapods的开源私有索引仓库)
大功告成!
当然,其实私有仓库的搭建,还有更高级的用法,AFNetworking
中的文件是分不同的目录,也就是不同的子模块的,其实就是用到的 s.subspec
,这个其实也很简单,需要指定子模块,具体可以参照AFNetworking,如果有疑问可以提问哦。
下面是我创建的私有仓库,后面我会把 subspec 也添加上去的:
JTSpecs
JTTest
最后,喜欢的小伙伴记得点赞收藏哦!😁😁😁
网友评论