基于Cocoapods搭建私有仓库实施组件化架构

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 * 可以搜到指定的第三方库的原因。

*.podspec.png

如果你想更深入的了解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。 (这里为了演示,我就设置为开源的,你可以设置为私有的)

JTSpecs远程索引仓库.png

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

最后,喜欢的小伙伴记得点赞收藏哦!😁😁😁

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,457评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,837评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,696评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,183评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,057评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,105评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,520评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,211评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,482评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,574评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,353评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,213评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,576评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,897评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,174评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,489评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,683评论 2 335

推荐阅读更多精彩内容