首先,也许有人觉得,开发使用远程私有库很麻烦,还不如直接写好,拖到项目中直接使用来的方便。可我想说的是,在一个小的项目中,这样也许可以,因为你的业务单一,功能少,可是当你在一个大公司的大团队中,公司对每一个功能模块性能要求十分严格的情况下,我们必须不定时的优化这个功能库,当你把这个功能库拖到你的项目中去了,那其他那么多人怎么办?都去拖?那就显得十分不好。那么组件化的概念就应运而生了。
这里,采用的是码市。因为GitHub上私有库是收费的,这个码市有免费个数的私有库足以用来演示创建远程私有库。
好了,你需要去注册一个账号,注册登录之后,是下图这样的:
第一步:我们创建远程私有索引库
说明:这个是索引库,存放索引文件
- 点击创建项目之后,如下:
- 点击网页左侧<代码>选项卡出现下面的界面:
那么此时,这个索引库在远程就建好了,而且它不是cocoapods的那个索引库,这一点要知道。接下来,我们要把这个索引库,给下载到本地。
我们先看看cocoapods本地已经有哪些索引库了。打开终端,输入: pod repo
说明:这个命令是查看本地索引库的
- 此时我们可以看到,本地.cocoapods目录下下面有一个仓库repos,里面有一个索引库master,而它的类型是git,远程地址在GitHub上,很显然,这是cocoapods自己的那个下载到本地的官方索引库。再看看我们的本地目录是不是这样呢?那当然是肯定的。
说明: cocoapods就在用户主目录下,也就是那个家目录,是一个隐藏文件。这里有一个快捷键(command + shift + .),可以很方便的显示隐藏文件。
- 下面,我们来把我们自己的远程索引库下载到本地,和cocoapods的官方索引库在同一级目录。
那么,在终端输入: pod repo add 仓库名 仓库源地址(SSH地址)
例如我输入的是: ZMF:~ apple$ pod repo add ZMFRemotePodspecs
https://git.coding.net/zhangmufeng/ZMFRemotePodspecs.git
- 运行上面的终端命令之后,再次执行终端命令:pod repo 查看当前的本地索引库,已经有两个repos了。看看本地索引库文件目录:
第二步:创建远程代码私有仓库
说明:这个是存放代码的私有仓库,不要和上面的私有索引库弄混淆了。
- 打开码市,新建本地代码仓库项目:
- 填写私有代码仓库信息,当然,里面的Readme文件、协议文件和忽略文件不填,这是因为我下面将采用官方模板的方式创建本地仓库。
-
创建好了之后跳转如下图:
说明:你的项目中可能有很多功能组件,都像上面创建多个远程私有仓库。
第三步:配置私有代码仓库我
-
创建一个总的文件夹,把本地私有库、远程私有库和主工程都放在这里。
-
这里ZMFRemoteRepo文件夹的架构如下:
-
接下来,很重要的一步,把采用把官方模板clone为本地仓库,放在ZMFRemoteLib文件夹下,因为,我想把所有的远程私有库都放在这个文件夹中。
- 打开终端,输入:pod lib create 远程仓库名
- 例如我输入的是:pod lib create ZMFRemoteBaseLib
- 输完回车之后,如下图停止了
- 然后,让你回答几个问题:
-
下面接着看看clone到本地的私有库
-
上面创建本地库的时候自动打开的测试工程如下:
-
先已打开的测试工程中,删除ReplaceMe.m文件
-
然后拖源码到Classes文件夹中
-
再cd 到测试工程目录,pod install安装刚才拖入的文件
-
打开测试工程,已经有我们的代码了
-
下面配置ZMFRemoteBaseLib.podspec文件,先对这个文件要修改的地方标注一下。
-
修改之后如下图:
第四步、到目前为止,我们本地仓库开发完毕。这些做完了,需要做后续上传操作:
提交
- 提交到本地: cd 到本地仓库下,git add . && git commit -m ‘提交说明’
- 提交到远程:git push origin master
-
之后,我们的远程私有库就这样了
- 打本地tag:git tag ‘0.1.0’ 说明:这个值要和.podspec里面的一至
- 把tag推送到远程: git push —tags
-
对.podspec文件进行两步验证。这个校验有两种,一种是pod lib lint 的本地校验,这个可以在.podspec文件配置就可以校验,一种是pod spec lint的远程校验,这个必须在远程私有库有这个版本且有这个文件里面的对应的tag值,才能校验,所以,这个校验,我放在了此处。
- 本地校验.podspec文件:
- 远程校验.podspec文件:
上传
接下来:我们需要把本地仓库的ZMFRemoteBaseLib.podspec文件上传到我们第一步创建的远程私有索引库中:
- 在终端中,把目录cd 到我们的本地仓库目录下,也就是ZMFRemoteBaseLib下面
输入命令:pod repo push 索引库名 索引文件名
例如:pod repo push ZMFRemotePodspecs ZMFRemoteBaseLib.podspec
说明:这个命令,其实先把索引文件推送到本地cocoapods的索引库,在由本地的cocoapods推送到我们的远程私有索引库。所以,这一步操作之后,cocoapods索引库和我们远程私有索引库都有了这个索引文件,不用再去推送到本地cocoapods索引库了。
-
看看我们的索引库:
在看看本地的cocoapods的索引库:cd 到用户主目录下,也就是家目录,终端输入:pod repo
-
文件就在这里就有了
第五步、测试远程私有库
那么此时,你的远程私有仓库就终于开发完成了。下面,我们建一个项目测试一下,建立项目就不写了。
- Podfile文件写法如下如下,我们的私有索引库的本地地址和远程地址可以通过上面的pod repo查看:
- pod install 之后如下:
- 打开工程:
在你学习本教程中,有啥问题欢迎留言或加入iOS技术交流群584141842,大家共同进步。