美文网首页
基于Cocoapods搭建私有仓库实施组件化架构

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

作者: Kenter_Huang | 来源:发表于2019-07-30 08:19 被阅读0次

    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

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

    相关文章

      网友评论

          本文标题:基于Cocoapods搭建私有仓库实施组件化架构

          本文链接:https://www.haomeiwen.com/subject/qlvurctx.html