我们想使用组件化的话,我们一般推荐采用pod库的形式来集成我们的组件到我们的宿主工程,那么我们首先要知道如何打造自己的专属私有远程库,我们先来看看远程私有库的一个图解
我们可以看到默认的远程的索引库中,其实是Cocoapods官方的索引库,其实也是我们本地索引库默认的master索引库,我们发布的再github上面的第三方框架信息都是在Cocoapods官方的索引库,但是我们私有的远程索引库毫无疑问是私有的,此时我们使用Cocoapods官方的索引库明显是不合适的。
那么我们势必需要打造一个我们专属的私有的远程索引库,然后将在我们拆分出来的组件生成一个.spec文件上传到我们私有的远程索引库。这个时候我们本地索引库新生成的检索索引文件既包含了Cocoapods官方的索引库的描述文件信息同时也包含了我们私有的远程索引库描述文件信息,此时我们使用pod search与pod install可以直接检索出我们组件框架的信息并且安装到我们的宿主工程中。
那么我们现在就一步步打造我们的远程私有仓库
一.创建远程私有索引库
我们首先进入.cocoapods文件夹下面,进入repos可以看到此时只有一个从默认远程索引库clone到本地的远程索引库master分支,我们需要添加一个新的远程私有索引库并且同样将它clone到我们的repos下面。
我们需要选用一个远程代码仓库,并且可以创建私有代码仓库的平台,在这里我们选择的时码市,因为它可以免费创建五个私有项目,当然也可以使用别的托管平台。
既然是私有远程索引库,所以我们现在需要添加一种验证方式,在这里我们采用ssh的验证方式,那么我们需要借助我们的终端生成我们的公钥和私钥,并且添加我们的公钥到我们账号下面
这个地方我们使用pod repo add 远程私有库名称 远程私有库地址,来clone远程私有库到我们的本地私有库中来,但是由于我们没有生成公钥和私钥,此时无法通过验证,我们需要配置我们的公钥和私钥
这个时候出现上图的画面说明我们公钥和私钥已经配置完成了,我们只需要在我们账号中配置我们公钥即可,首先我们需要找到我们的公钥和私钥
这样的话我们的权限就配置好了,我们继续clone远程索引库到我们的本地索引库中来,
此时我们还需要创建一个远程私有的代码仓库,我们这边用来放我们的基础组件
然后我们在需要集成的基础组件的工程同级目录下创建一个文件夹我们命名为remoteLib
打开终端,进入到这个文件夹下面来使用pod lib create 远程私有框架库,clone我们的模板库
然后我们需要做几步简单地设置
分别是语言的选择,生成演示demo,测试框架,view基础测试以及测试demo的文件前缀
此时我们会自动打开我们的演示demo工程
我们需要将clone的远程私有索引库中的class文件夹下的内容替换成我们基础组件的内容
然后进入我们测试demo里面使用pod install安装一下,测试是不是可以成功安装,并且编译一下看有没什么问题
我们发现确实集成成功了,如下图所示
现在我们需要将TZSoundBase.podspec文件里面的内容进行修改
紧接着我们来校验一下我们.spec文件是否合法,因为即使我们不做校验,在上传到远程私有索引库的时候也会自动进行校验,如果不通过我们还是得回到.spec文件中去修改的。
在这个地方我们使用的是pod lib lint,它代表的是本地的校验,如图所示,校验通过了没有问题,接着我们再来使用一下远程校验,我们使用pod spec lint
我们使用远程校验的时候居然出错了,其实查看提示我们可以得知,原因是我们没有版本号对应的tag值,而在本地校验的过程中其实是没有去校验我们的source属性的,当然也不会校验我们的tag值是否存在。
但是其实此时我们TZSoundBase远程代码仓库里面没有任何文件,也没有同TZSoundBase的本地代码仓库进行连接,所以我们现在首先就是应该将两者连接起来,并其将代码同步到远程代码仓库中去
此时我们再来使用pod spec lint远程校验一下
现在远程校验就通过了,现在我们就应该将TZSoundBase.podspec文件提交到我们的私有远程索引库里面去。
我们先来查看一下我们本地索引库
我们要将TZSoundBase.podspec提交到我们的远程私有索引库(TZSoundSpecs)当中去,使用pod repo push 远程私有索引库名称 框架名称的描述文件
如图所以,我们提交描述文件其实经历了两个步骤,首先其实是将我们的描述文件提交到本地的私有索引库中,然后本地私有索引库会自动将描述文件同步到我们的远程私有索引库当中,这里我们再看一下开头的那张示意图
稍作修改,将我们.spec文件提交到我们远程私有索引库的真实过程描述了出来
接下来我们看一下我们本地私有的索引库和我们远程私有索引库当中我们的描述文件是否提交上去了
先看一下我们的本地私有索引库
再来看一下我们的远程私有索引库
接着我们再室友pod search 看能不能搜索到我们基础组件的框架信息
最后我们把远程私有库里面的基础组件集成到我们的宿主工程中就行了
打开podfile文件,由于我们现在使用的时远程私有索引库,索引我们不需要给出本地地址
我们现在使用pod install来安装我们的基础组件
但是我们发现并没有安装成功,为什么呢?
其实是因为我们此时远程索引库有两个一个是默认的Cocoapods官方索引库,一个是我们的远程的私有索引库,我们在podfile文件中并没有指明我们需要从哪个索引库中去安装我们的基础组件,所以此时会默认的从Cocoapods官方索引库中去搜索并且安装,但是我们的基础组件并不在其中,所以安装失败了。那么我们需要做的就是指明我们要从哪个远程索引库当中去安装我们的基础组件。
我们先把索引库的地址找到
然后在podfile文件中指明我们的索引库
此时我们再使用pod install来安装我们的基础组件
根据终端的提示,已经将我们的基础组件安装到我们的宿主工程中去了,我们再打开我们的宿主工程看一下是否成功了
这样的话我们远程私有索引库的打造就完毕了,但是这个地方还有个小问题,需要我们注意一下。
现在我们再试着集成一下我们的AFN看看会发生什么问题
咦?居然安装失败,是不是有点不合理。
其实原因同上,在我们没有指定任何源的时候,默认的就是Cocoapods的官方索引库,而现在我们指定了远程私有索引库,所以安装pod库的时候只会从我们的远程私有索引库中去安装,我们的私有远程索引库当中当然不存在AFN框架的描述信息,所以我们也必须将Cocoapods的官方索引库的源指定出来
现在我们在使用pod install来安装一下我们的AFN
再看看我们的工程里面AFN是否安装成功了
那么至此我们今天所讲的打造远程私有库的内容就完毕了,那么下次我们来谈谈如何给我们的远程私有库升级。